Skip to content

Code Releases

Luis Herranz edited this page May 12, 2021 · 5 revisions

Frontity keeps the docs updated with the latest features released in the source code.

This is the community discussion regarding this topic: Code <-> Documentation workflow

For every new feature, bug fixing, or code update that requires a change in the docs, this is the workflow to follow on both the code repository (code PR) and the docs repository (docs Issue):

  • The Pull Request with the Feature is merged
  • The Feature Discussion is updated with a Section "Final Implementation" (like this one) where the details to understand and use the feature are explained. You can use this template.
  • An issue for documenting the feature is created in the API Reference repository with the following info:
    • Related code PR link
    • Related Final Implementation link
    • Related community forum posts or feature discussions links
    • Any other info that can help in the documentation task
    • Labels
      • priority: high → This should be the default priority but the developer can assign another one from the ones available. The people in charge of documentation will take this priority into account but will decide the final priority for the task
      • type: code release → This label will help locate those issues generated from a code PR
      • any other label that can help to understand better the scope of the issue (max 2 more labels). Example: topic: cache, topic: packages

Documentation changes before code releases

  • To simplify the process the work is currently being done against the master branch and no documentation task will be merged until the related feature has been released
Clone this wiki locally