Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
en:wiki:newcomer [2024-09-02 16:02] – Anatoly Belaychuken:wiki:newcomer [2024-09-02 21:07] (current) – Anatoly Belaychuk
Line 1: Line 1:
 ====== Tips for beginners ====== ====== Tips for beginners ======
  
-So you are ready to get promoted from consumer to contributor of good BPMN.+So you are ready to be promoted from consumer to contributor of good BPMN.
  
 Here is what you should do. Here is what you should do.
Line 7: Line 7:
 ===== 1. Start liking ===== ===== 1. Start liking =====
  
-Please note a prompt "Was this page helpful?" at the top of (almost) every page.+Please note a prompt ''Was this page helpful?'' at the top of (almost) every page.
 Press like or dislike icon and the counter will change. Press like or dislike icon and the counter will change.
 This will help authors better understand the value of their content. This will help authors better understand the value of their content.
-The sidebar on the left displays the "Top-10" - the ten pages with the highest rating.+The sidebar on the left displays the ''Top-10'' - the ten pages with the highest rating.
  
 You don't need to register to like/dislike a page. You don't need to register to like/dislike a page.
Line 16: Line 16:
 ===== 2. Create an account ===== ===== 2. Create an account =====
  
-To comment and add content, you need to [[ru:?do=register|register]].+To comment or add content you need to [[en:?do=register|register]].
 (Or [[en:?do=login|login]] if you already have an account.) (Or [[en:?do=login|login]] if you already have an account.)
  
 ===== 3. Create a Home Page ===== ===== 3. Create a Home Page =====
  
-This step is optional, but your contributions will be viewed more favorably if you introduce yourself to the community.+This step is optional but your content will get more attention if you introduced yourself to the community.
  
-To create a home page, find Home Page in the drop-down menu in the upper right corner. +Find the ''Home Page'' in the drop-down menu in the upper right corner. 
-Click on this link and create a page.+Click the link to create a page.
  
-The home page is where you can tell us about yourself. +The home page is the place to introduce yourself. 
-Information about experience and regalia is welcome.+Information about experience and achievements is most welcome.
  
-===== 4. Upload an avatar =====+===== 4. Upload avatar =====
  
-If you want your avatar to appear in comments, upload a file named //username//.jpg or //username//.png to your personal space (user///username//).+If you want your avatar to appear in comments, upload a file named ''//username//.jpg'' or ''//username//.png'' to your personal space (''user///username//'').
  
-===== 5. Practice with markup =====+===== 5. Practice with DokuWiki formatting =====
  
-BPMNbox runs on the [[doku>DokuWiki]] wiki engine. +BPMNbox runs on [[doku>DokuWiki]]. 
-References:+Help pages:
  
-* [[syntax]] +  * [[en:wiki:syntax]] 
-* [[good style]]+  * [[doku>tips:good_style|Hints on good style]]
  
-But perhaps the easiest way to learn markup is to find a page that implements what you need, look at it, copy and paste its source code+Probably the shortest way to learn formatting language is to find a page that implements what you need, copy & paste the source code.
  
-Use your home page as a sandbox for learning markup, or (better) create a page under your home page: user///username/somepage//. +Use your home page as a sandbox, or (better) create a page under your home page, e.g. ''user///username///playground''.
- +
-:!: Note that the content of your home page will be visible to other (registered) users. Subpages are visible only to you.+
  
 ===== 6. Start commenting ===== ===== 6. Start commenting =====
  
-Found a typo? Something unclear? Want to argue?+Found a typo? Need explanations? Want to discuss?
  
-Scroll to the bottom of the page to the "Discussion" section and leave a comment.+Scroll to the bottom of the page to the ''Discussion'' section and make a comment.
  
-* you can use all markup languages ​​in comments, including drawing BPMN diagrams +  * you can use all markup features ​​in comments, including drawing BPMN diagrams 
-* you can create a top-level comment or reply to an existing comment+  * you can create a top-level comment or reply to an existing comment
  
 ===== 7. Start suggesting edits ===== ===== 7. Start suggesting edits =====
  
-If you see that you can significantly improve the quality of the existing page, find the "Edit page" button and go ahead!+If you are able to improve an existing page, find the ''Edit this page'' button and go ahead!
  
-Don't be afraid to screw something up - previous versions of the page are saved.+Don't be afraid to screw something up - previous versions of the page are stored anyway.
  
-The page you edited will have the "draft" status until it is approved by one of the moderators. +The page you edited will have the "draft" status until it is approved by a moderator. 
-Only after that will the new version be visible to all users.+Only after that the new version will be visible to other users.
  
-===== 8. Start writing your own articles =====+===== 8. Start writing your own pages =====
  
 You can create a new page in three ways: You can create a new page in three ways:
  
-* Use the "Page Tools" button in the top menu. In the drop-down list, select the namespace and enter the name of the page. +  * Use the ''Page Tools'' button in the top menu. Select the namespace from the drop-down list and enter the name of the page. 
-* Enter the address of a non-existent page in the command line. +  * Enter the address of a non-existent page in the command line. 
-* Create a link on an existing page. Save the page, follow the link and create a new page. This method is preferable because you are not only creating a new page, but also linking it to existing content.+  * Create a link on an existing page. Save the page and follow the link to create the new page. This method is preferable because not only a new page is created, but it's linked to existing content.
  
-Usually, websites display error messages when you try to go to the address of a non-existent page. +Usually, a website displays error messages when you enter the address of a non-existent page. 
-Wiki sites are different - they consider this not an error, but a (yet) unwritten page, and invite you to create it. +Wiki sites are different - they consider this isn't an error but a (yet) unwritten page, and invite you to create it. 
-Find the "Create page" button in the menu on the right and start creating.+Find the ''Create this page'' button in the menu on the right and start editing.
  
-To translate a page into another language, use the "Translate this page" drop-down menu at the top.+When created, the page obtains headings structure from the template - preserve them for pages of the same type to have the same structure.
  
-:!: BPMNbox is an international resource, so specify the page name in the address bar or in the link in English. +To translate a page into another language, use the ''Translate]ions of this page'' drop-down menu at the top.
-The Russian name will be displayed, which will be taken from the first-level heading in the page text.+