erpnext icon indicating copy to clipboard operation
erpnext copied to clipboard

Improved Documentation: Currently documentation is inaccurate and very messy.

Open c0fe opened this issue 2 years ago • 1 comments

I am going to open a new ticket since the other one was closed as not something to be fixed and incorrectly stated that a required component was listed in the documentation, it wasn't unless you read the instructions on how to install the programs individually.

This brings me to the purpose of this issue. The documentation is a mess, it is incomplete and pertains errors. ERPNext includes two variants, Docker and Manual, the manual has one step, install Frappe. This is the equivalent of saying that the only step to installing a .Net program is to install .Net framework. You need to expand on that, saying that being the only documented step is obviously wrong.

Frappe installation is messy as well, you have to go through 3 links for some reason to get to a website that includes the instructions. Docker installation is a mess, not to mention using markdown files on Github instead of an already made and significantly better designed documentation site is very strange. Overall the whole thing is just all over the place and skips several steps.

I would offer to rewrite but the reception to me bringing this issue up in the first place has been very poor. So the suggestion is this, fix your documentation, it is a massive mess rather than deny it is.

c0fe avatar Jun 01 '23 02:06 c0fe