Chapter on projects - Githubissues

mbakeranalecta commented 10 years ago

There is currently no chapter on projects. They are mentioned in a few places:

In a couple of topics on configuration settings
In the chapter on editing XML documents at http://www.oxygenxml.com/doc/ug-editor/#topics/grouping-documents-xml-projects.html. This topic mentions in passing that projects can be shared between team members.
In topics on validation scenarios
In topics on transformation scenarios
In a topic on sharing projects with SVN, which I suspect is not referring to project files at all, but could be quite confusing to the reader who does a docs search for "project".

But there is no chapter about projects. I think there should be. Projects are an important part of Oxygen, and a lot of its functionality works through the project. Users would benefit from guidance on making the best use of projects, especially across teams.

raducoravu commented 10 years ago

So somehow your idea would be to move the "grouping-documents-xml-projects.dita" on a higher level of the main dita map as a chapter? And maybe add more subtopics to it?

mbakeranalecta commented 10 years ago

Something like that, yes. As a user myself, I don't think I am fully exploiting the capability of projects. I think more focused documentation could help people get more out of them.

raducoravu commented 10 years ago

I agree. The project functionality should be better promoted and explained.

oxygenxml / userguide

Chapter on projects #22