From Pearl Language
Jump to: navigation, search



Creating and editing pearls

Please see form:oyster to create and edit a pearl and its properties.

Singular page name and plural redirect

Often you need both the singular and plural version of a page. For example, if you have user story, you will probably also need user stories at some point in time. Therefore:

  1. write the original page in singular form; and
  2. create a redirect to the original page for the plural form.

Special characters

Create a redirect without the special character for page names that use special characters like ‘?’ or ‘!’. For example, anyone else redirects to anyone else? so that the permalink takes you to anyone else?.

Use a right single quotation mark

Use a right single quotation mark “’” in page names when appropriate. That is, do not use a straight quote “'”. For example, don’t just do something, stand there!.



Verb-based topics

  • For every key topic, use the corresponding verb as main entry point.
    For example, use Decide (from the verb ‘to decide’) as the main page for all topics related to the action to decide, like decision-making, consent, and sociocracy.
  • Redirect the corresponding category page to the main page on this topic.
    For example, category:decide contains #REDIRECT [[decide]].
  • Tag each page with the appropriate categories. Consider using property:theme for major topics.

Main category pages and redirections

You want pretty URLs because URLs are part of the user experience. Therefore

  1. Create a specific page for key concepts and topics so they are accessible by:
  2. Have the topic page redirect to the category page:
    #REDIRECT [[category:topic]]
  3. Put all the meat on the category page.