Skip to content

Commit

Permalink
DOC Update documentation about documenation (#380)
Browse files Browse the repository at this point in the history
- Slight change to headings for improved scan-reading
  • Loading branch information
GuySartorelli committed Oct 24, 2023
1 parent 4bdfce0 commit a6d4f74
Show file tree
Hide file tree
Showing 3 changed files with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions en/05_Contributing/06_Documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,19 +163,19 @@ Relative documentation links are prefixed with `./` for pages in the same direct

Absolute documentation links are preferred for pages which aren't in the same directory or one level up. The language and version number are ommitted. For example `[managing lists](/developer_guides/model/lists/)` becomes [managing lists](/developer_guides/model/lists/).

#### Links to API documentation
### Links to API documentation

API documentation is linked in a special way. Give some examples for classes, methods, properties.

For classes, interfaces, traits, and enums:
#### For classes, interfaces, traits, and enums

``[`Form`](api:SilverStripe\Forms\Form)`` will become [`Form`](api:SilverStripe\Forms\Form), and will link to the API documentation for the `SilverStripe\Forms\Form` class.

For methods:
#### For methods

``[`Form::makeReadonly()`](api:SilverStripe\Forms\Form::makeReadonly())`` will become [`Form::makeReadonly()`](api:SilverStripe\Forms\Form::makeReadonly()), and will link to the API documentation for the `makeReadonly()` method in the `SilverStripe\Forms\Form` class.

For properties, including configuration properties:
#### For properties, including configuration properties

``[`Form->casting`](api:SilverStripe\Forms\Form->casting)`` will become [`Form->casting`](api:SilverStripe\Forms\Form->casting), and will link to the API documentation for the `casting` property in the `SilverStripe\Forms\Form` class.

Expand Down
Binary file modified en/_images/contributing/docs-commit-message.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/_images/contributing/docs-use-correct-branch.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a6d4f74

Please sign in to comment.