Files
helidon/docs-internal
Romain Grecourt 0f6403374f Application poms (#1022)
Create a new parent pom hierarchy to fit new applications-pom
Updated all examples to use the new application-poms
Normalized examples README.md
Updated examples Dockerfile to multi-stage
Remove dependency management for microprofile-metrics-api and leverage the transitive dependencies of helidon-metrics and helidon-metrics2.
2019-09-12 15:48:09 -07:00
..
2019-01-02 17:05:07 -08:00

Internal Documents and Specifications

This directory contains internal documents and specifications. These fall into a number of categories:

  • Guidelines and best practices
  • Design documents
  • Feature proposals
  • Or pretty much anything else

By keeping our documents as source code we can easily find them and easily review them.

Specs vs GitHub Issues

In many cases GitHub issues are sufficient for tracking requirements and basic proposals. But a spec might be more appropriate if you want an easy to review, living document with a fair amount of detail.

Use Markdown

Write your specs in Markdown. AsciiDoc is also OK if you need it.