mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-07-24 17:32:15 +00:00
[ADF-1586] Added boilerplate files to doc folder (#2603)
This commit is contained in:
committed by
Eugenio Romano
parent
189bc6513d
commit
856f094598
63
docs/boilerplate.component.md
Normal file
63
docs/boilerplate.component.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
# Boilerplate component
|
||||||
|
|
||||||
|
Shows how to write a Markdown file for a component.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
<!-- Most doc files don't need a table of contents. Delete this part unless
|
||||||
|
you have added about five subsections in the Details part.
|
||||||
|
-->
|
||||||
|
<!-- markdown-toc start - Don't edit this section. npm run toc to generate it-->
|
||||||
|
|
||||||
|
<!-- toc -->
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
|
<!-- markdown-toc end -->
|
||||||
|
|
||||||
|
## Basic Usage
|
||||||
|
<!-- Delete any Basic Usage parts that you don't need (eg, some components don't
|
||||||
|
have any properties). -->
|
||||||
|
|
||||||
|
```html
|
||||||
|
<adf-document-list
|
||||||
|
#documentList
|
||||||
|
[currentFolderId]="'-my-'"
|
||||||
|
[contextMenuActions]="true"
|
||||||
|
[contentActions]="true">
|
||||||
|
</adf-document-list>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Properties
|
||||||
|
|
||||||
|
| Name | Type | Default | Description |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| prop1 | string | 'hello' | The property description in the table should be no more than a few sentences. Add extra description in the Details section if you need to. |
|
||||||
|
| prop2 | boolean | true | Prop tables should have name, type, default and description, in that order. Leave default value blank if appropriate. |
|
||||||
|
|
||||||
|
### Events
|
||||||
|
|
||||||
|
| Name | Description |
|
||||||
|
| --- | --- |
|
||||||
|
| someEvent | Keep description short for the table. Usually starts with "Emitted when..." |
|
||||||
|
| anotherEvent | Emitted when the user double-clicks a list node |
|
||||||
|
|
||||||
|
## Details
|
||||||
|
|
||||||
|
**Note: This is not a real component!**
|
||||||
|
|
||||||
|
Copy the contents of this file when you create a new component doc and edit or remove bits of it
|
||||||
|
as necessary. Usually, the title should be derived from the Angular name with the kebab-case expanded
|
||||||
|
(so "task-details.component" becomes "Task Details component") but there is no need to stick to this
|
||||||
|
if it looks wrong to you.
|
||||||
|
|
||||||
|
### Subsection
|
||||||
|
|
||||||
|
You don't need to make subsections in the Details part but add them if they help with the
|
||||||
|
explanation. Add them as level 3 headings in the Details part only - to keep the consistency
|
||||||
|
of the docs, you shouldn't normally add any new level 1 or 2 sections to the Markdown.
|
||||||
|
|
||||||
|
<!-- Don't edit the See also section. Edit seeAlsoGraph.json and run config/generateSeeAlso.js -->
|
||||||
|
<!-- seealso start -->
|
||||||
|
|
||||||
|
<!-- seealso end -->
|
42
docs/boilerplate.service.md
Normal file
42
docs/boilerplate.service.md
Normal file
@@ -0,0 +1,42 @@
|
|||||||
|
# Boilerplate service
|
||||||
|
|
||||||
|
Shows how to write a Markdown file for a service.
|
||||||
|
|
||||||
|
## Methods
|
||||||
|
|
||||||
|
`someMethod(value: string = '')`<br/>
|
||||||
|
Shows how to document a method.
|
||||||
|
|
||||||
|
`anotherMethod(value: string = '')`<br/>
|
||||||
|
Shows how to document a method.
|
||||||
|
|
||||||
|
## Properties
|
||||||
|
|
||||||
|
| Name | Type | Default | Description |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| prop1 | string | 'hello' | Many services don't need a properties table. Delete this section if you don't need it. |
|
||||||
|
| prop2 | boolean | true | Prop tables should have name, type, default and description, in that order. Leave default blank if appropriate. |
|
||||||
|
|
||||||
|
## Details
|
||||||
|
|
||||||
|
**Note: This is not a real component!**
|
||||||
|
|
||||||
|
Copy the contents of this file when you create a new service doc and edit or remove bits of it
|
||||||
|
as necessary. Usually, the title should be derived from the Angular name with the kebab-case expanded
|
||||||
|
(so "page-title.service" becomes "Page Title service") but there is no need to stick to this
|
||||||
|
if it looks wrong to you.
|
||||||
|
|
||||||
|
The main difference between service and component docs is that services usually have methods. Replace
|
||||||
|
the method signature and description with your own text but keep the <br> at the end of the
|
||||||
|
signature line.
|
||||||
|
|
||||||
|
### Subsection
|
||||||
|
|
||||||
|
You don't need to make subsections in the Details part but add them if they help with the
|
||||||
|
explanation. Add them as level 3 headings in the Details part only - to keep the consistency
|
||||||
|
of the docs, you shouldn't normally add any new level 1 or 2 sections to the Markdown.
|
||||||
|
|
||||||
|
<!-- Don't edit the See also section. Edit seeAlsoGraph.json and run config/generateSeeAlso.js -->
|
||||||
|
<!-- seealso start -->
|
||||||
|
|
||||||
|
<!-- seealso end -->
|
Reference in New Issue
Block a user