Technical articles - file tree
What
Create a dir doc/articles/
to put all the technical articles there, regardless their subjects.
Why
- It does not depend on any docs' restructure / reorg
- Later (when we get rid of
/help
, have kramdown, and frontmatter in docs) we can make a nice layout forarticles/index.hml
and enable sorting and filtering articles by categories, tags, etc.
What
-
Update Writing Docs page (https://docs.gitlab.com/ce/development/writing_documentation.html) => https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10752 -
Update style guidelines (https://docs.gitlab.com/ce/development/doc_styleguide.html) => https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10752 -
Update docs/contributing (https://gitlab.com/gitlab-com/gitlab-docs/blob/master/README.md) => https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/62 -
Relocate
Upcoming articles (community writers):
- Phoenix/CI (gitlab-com/www-gitlab-com!4070 (closed))
- Undo things in Git (gitlab-com/www-gitlab-com!4197 (closed))
cc/ @seanpackham @axil