Help:Style

To achieve a consistent look and feel across all pages of Alpine Linux wiki, editors must follow the below style guidelines as much as possible.

Page title and headings

• Page titles and all headings should use sentence case.
• Avoid including Alpine Linux in headings.
• Start headings at level 2, and don't skip levels.
• First-level headings and their formatting is used for article title.

Section organization

Every page should begin with an introductory lead section – a concise summary of the article – which is never divided into sections. The remainder of the article is typically divided into sections. The following sections are recommended on all wiki pages:

=== Prerequisite ===
 If there any Prerequisite, it must be properly listed here.
=== Installation ===
 The Installation section must appear early in the page.
=== Configuration ===
 The Configuration section must follow with detailed sub-headings to handle all sub-topics.
=== Troubleshooting ===
 Troubleshooting section must include common errors that may be encountered by the users.
=== See also ===
 Add both internal wiki links and external references relevant to the page in this section.

Bulleted and numbered lists

• Do not use lists if a passage is read easily as plain paragraphs.
• Use numbers rather than bullets only if:
  • a need to refer to the elements by number may arise;
  • the sequence of the items is critical;

Links

Make links only where they are relevant and helpful in the context: Excessive use of hyperlinks can be distracting and may slow the reader down. Add links only that are worth pursuing.

Check links: Ensure the destination is the intended one and test them.

External links should not normally be used in the body of an article and instead Use #See also section for placing them. Add external links with discretion and do not use wiki for self-promotion.

Category

Every page should be assigned at least one category from among the categories list by placing them at the bottom of the page.

See also

• How to write a HOWTO
• Wikipedia Manual of Style
• Archwiki Help:Style