Attention!
Dear PSL contributor, you will not be able to create pages in the space for the foreseeable future due to the global documentation project, This action is being reserved to process experts, administrators and IS to ensure consistency and avoid duplication while the documents are under review.
Table of contents
Create a page
Choose a template
Create a draft and fill it with content
- Create an appropriate title
- Label your page
- Place the page under the appropriate category
- Publish the page by using the approval workflow
Content and Templates
General rules
- Beautiful is better than ugly.
- Explicit is better than implicit.
- Simple is better than complex.
- Complex is better than complicated.
- Sparse is better than dense.
- Readability is important.
- Special cases aren't special enough to break the rules. Although practicality beats purity.
- Title is the beacon of your page, make it count.
- Have one and only one page per process.
- Your document is a web page, treat it like one.
Templates
Coming soon.
Categories
Each new page must be placed under one of the space categories and be appropriately labeled. If the page does not fin in any of the categories it must be placed in the Other documents section.
Labels
General rules
- Always label your pages
- Separate words within labels with an underscore
- Do not combine system or product names within a single label
- Prefer to use existing labels, than creating new ones that are similar
- Specify the language of the page with a label if the language is not English
Labels mentioned below are to be used as described and without variations.
Category labels
| Type | Use-case | Labels to use |
|---|---|---|
| Organizational procedure or policy | A description of of how an activity is carried out, it's goals, scope and expected results. Process maps. | |
| Standard operating procedure | A set of step-by-step instructions compiled to help workers carry out routine operations. | |
| Specific | Specific instructions for a region, country or site that deviate from the standard process. | |
| Control | A description of controls performed to ensure operational effectiveness and efficiency, reliable financial reporting, and compliance with laws, regulations and policies. | |
| Landing page | A title page for grouping pages with similar content | |
| Other | All other page types that do not fall under one of the above mentioned categories. | no label |
Content labels
| Topic | Use-case | Labels to use |
|---|---|---|
| Accounts Payable | Pages or content related to accounts payable | |
| Provisioning | Pages or content related to provisioning | |
| Travel and Expenses | Pages or content related to travel and expenses | |
| Payments | Pages or content related to payments | |
| Support | Pages or content related to supporting or transversal functions | |
| Master data | Pages or content related to master data | |
| SAP transactions | Pages or content containing description and use of SAP transactions | |
| Report | Pages or content related to creating or maintaining reports | |
| Application | Pages or content related to an application or a program used by purchasing; like AoDocs or Convergence. Describes the functions and use of the program. |
Location labels
| Location | Labels to use |
|---|---|
| North America | |
| Latin America | |
| Asia Pasific | |
| Europe, the Middle East and Africa | |
| World-wide |
Specific labels
| Type | Description | Label example |
|---|---|---|
| Language | Use when labeling non-English documents / pages. Use word language followed by an underscore and a 2 letter country code (ISO Alpha-2). | language_pt |
Document maintenance
| Document type | Maintenance and updates |
|---|---|
| Process descriptions, Standard operating procedures, Controls and Specifics | Documents must be reviewed at least once a year. Outdated documents will be archived without prior notice. |
| Other | On demand |
| Document status | Maintenance |
|---|---|
| Drafts | Documents with this status with no published version will be deleted if they remain in this status for longer than a month. Documents with an existing published version will be archived. The reference date is the date when status was last changed. |
| For Review | Documents with this status with no published version will be deleted if they remain in this status for longer than a week. Documents with an existing published version will be archived. The reference date is the date when status was last changed. |
| To be approved | Documents with this status will be archived if they remain in this status for longer than a week. The reference date is the date when status was last changed. |
Retention policy
| Document type | Retention |
|---|---|
| Process descriptions, Standard operating procedures, Controls and Specifics | Obsolete documents must be kept in archive for 2 years before deletion. |
| Other | If no longer in use, the page may be deleted. |