humanmade / humanmade/hm-base

Include a set of standard documentation

Open
#101 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
PHP
Stars
80
Forks
18
PR merge metrics
No merged PRs in 30d

Description

On every project so far, the team compiled a set of documentation inside the Wiki. Some of this documentation was project specific, but a lot of it was generic.

This approach has a couple of issues:
- Documentation is often created late, after developers struggled with certain tasks, for example during onboarding.
- The is a lot of duplication between the projects, but the documentation is created anew for each of them.
- Wikis do not get cloned along with repositories. This makes setting up boilerplate documentation difficult, and it also prevents the documentation from being accessed and edited locally.

What I propose is to include a `docs` directory inside of HM Base. Some its content is developer focused, some of it is project management specific. So the contents would need to be elaborated with the PM team.

This would serve as a good basis for future projects. PMs will need to adapt certain documentation for each project, but they could just use the editing functionality build into Github to do so.

We would need to adapt our deploy workflow to not deploy these files, as their contents are private.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.