ecamp3 icon indicating copy to clipboard operation
ecamp3 copied to clipboard

Strategy for documentation

Open carlobeltrame opened this issue 5 years ago • 3 comments

We currently have documentation in:

  • docs: Use case descriptions
  • docu: Setup and deployment instructions
  • Wiki: The rest
  • Upcoming documentation for ApiInput and EInput components
  • Upcoming documentation for translation file structure #528
  • Upcoming documentation about timezones / UTC and more in the API #581
  • (also Swagger OpenAPI Documentation)

I'd like to propose to move all documentation (except for OpenAPI) to the wiki, since that can be easily edited without opening a PR for each typo. Downside: When changing something, we also have to remember to update the wiki.

carlobeltrame avatar Nov 16 '20 18:11 carlobeltrame

Agree for

  • Setup, deployement, general docu, etc. --> wiki
  • Swagger / Open API--> repo
  • ApiInput, EInput (maybe other general components such as DialogBase, DialogForm) --> not sure 🤔💭 / in code docu not suffienct?

usu avatar Nov 17 '20 18:11 usu

Meeting Discussion

  • [ ] Wiki:
    • [ ] Principles
    • [x] Setup
    • [x] Deployment
    • [ ] Big Picture
    • [ ] API basics including timezones and link to Swagger
    • [x] Frontend Basics
    • [x] Locale JSON structure
  • [x] Repo: Swagger / Open API
  • [ ] Comments on props in Vue Components
  • [ ] Try to generate component types?

manuelmeister avatar Dec 08 '20 20:12 manuelmeister

The documentation in backend/module/eCampApi/config/documentation.config.php should be updated to reflect the changes in #806 and #834.

carlobeltrame avatar Feb 10 '21 16:02 carlobeltrame