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