Explain an asset of your work. Add this document to a day in your diary.
An asset is something to remember that achieves something of interest. This may something to communicate in a daily standup.
The asset is strictly personal and part of a developer's diary. Typically it is added, like event documents, to a day document.
Properties
The document type asset provides the following properties:
Parent
The parent document is expected to be of type Day.
Creator of the Asset
Automatic property to add the user who created the asset description. Useful if assets of multiple team members are shown in a table.
Date
Automatic property to add the date for the creation of the asset.
Rating
A personal rating for the importance of the asset.
Object
Add links to documents that refer to entities this asset is concerned with.
File
Add a link to a todo document this asset is related to.
Sections
Description
The description of the asset.
Business Value
A description of the value this asset has from the business point of view.
Considering this is important for developers if they want to communicate the asset to team members that are less enthusiastic about the inner technical beauty, but are more concerned on the user's or customer's point of view.
Personal Value
Since this is an entry in the developer's diary, this is of interest for the developer.
Subordinate Assets
In case the asset contains multiple parts. Each asset would be referable by an URL.
Notes
These are internal notes that are usually not exported and only visible to team members with write access.
But this is not a safe place to store sensible information. It is just a convenience for the reader to not be bothered with notes stored here for the authors for later use. The security level is about suppressing the representation by a CSS style. Therefore consider this as a convenience for the reader, not as a security tool.
References
For a document the references section contains pointers to resources that prove the statements of the document.
Often these proofs are not easily distinguishable from further information. In this case you may want to skip the reference section in favour for the resource list.
Resources
The resources section provides references to further information to the topic of the document.
This may be information on the internet provided by the resource or information in the team's information systems. Anything the reader of the resource might want to know, may be listed here.