I
I
IvanN7772018-03-07 07:36:43
Documentation
IvanN777, 2018-03-07 07:36:43

What is the best way to write technical documentation for a working project?

It so happened that I was appointed senior, on a dying project, zasran in the trash.
According to which there is no documentation and there was no smell of tests.
I want to start documenting processes in particular.
So-how you need to understand what-how it works and for the team to see it.
And it will come in handy for writing tests and refactoring.
I have already looked at some overview of the documentation.
But since people here are very interesting, I decided to consult.
I would like to find something not very difficult to master, so that it does not take a lot of time.
If anyone has done something similar, I'd love to know.

Answer the question

In order to leave comments, you need to log in

6 answer(s)
E
Edward Tibet, 2018-04-20
@eduardtibet

IvanN777 To get your thoughts in order, start with this answer: What's the best way to do company documentation?

R
Roman Mirilaczvili, 2018-03-07
@2ord

Our team uses DokuWiki. There is a search in the documentation, the history of previous edits, etc. Better than Word.
Installation in Ubuntu/Debian Linux is simple, through a regular manager.
As far as documentation is concerned, it is worth making a map of the various parts of the project and linking to them in a hierarchy. You can attach images of various diagrams, links to external resources, etc. It is also convenient to refer to some internal systems, say JIRA:
DokuWiki uses namespaces to maintain a hierarchy.

O
Oleg, 2018-03-07
@402d

you add comments in the code and hints start to appear in the IDE, and you can also generate html documentation
https://www.phpdoc.org/
https://github.com/phpDocumentor/phpDocumentor2

D
Denis _______________, 2018-03-09
@LuchS-lynx

I would look towards wiki engines. In my opinion, the most functional, including plugins, are mediawiki, dokuwiki, twiki, xwiki, confluence. In my opinion, the last 2 have a more user-friendly interface.

A
Anton, 2018-03-07
@karminski

Microsoft Word, Google Docs

A
Alexander null, 2018-03-07
@snikes

Use MD

Didn't find what you were looking for?

Ask your question

Ask a Question

731 491 924 answers to any question