Documentation #1691
open
- Subject changed from Docs: Conevrt windows docs to Docs: Convert windows docs
Yeah - I was thinking both - wiki alongside the rest of the guides (which i can add in) and the new format that you are working on.
So I guess if I add it in the wiki - after that I would need to do a pull req against the repo right or?
Peter Manev wrote:
Yeah - I was thinking both - wiki alongside the rest of the guides (which i can add in) and the new format that you are working on.
So I guess if I add it in the wiki - after that I would need to do a pull req against the repo right or?
But then we'd be maintaining the guides in 2 different formats. Do we really want to do that?
No - we dont want that - extra admin effort in keeping those in sync.
In that case - Sphinx is the way to go I suppose?
Yup, especially since sphinx can do pdf output.
Victor Julien wrote:
Yup, especially since sphinx can do pdf output.
Yes, Sphinx would be ideal.
But keep in mind, all the other install documentation is remaining on the wiki, at least for now. Main reason being is that it depends on factors external to Suricata (the target OS in question) and maybe should not be snapshotted to a specific Suricata version, but be more live.
I'm going to keep my eye out for other project install docs, and see what they do. Its much nicer to write in Sphinx/rEst IMO.
Windows, esp specific versions, should be quite stable. Much like the CentOS/Ubuntu LTS ones, right?
Yes, I expect so. Sometimes things change. For instance, EPEL gained the necessary libnetfilter_queue packages for CentOS 6 some time ago, so we were able to add that to the default install docs which we weren't able to do when CentOS 6 was still fairly new. Of course, this would not have broke existing docs.
- Assignee set to Peter Manev
Victor Julien wrote:
Windows, esp specific versions, should be quite stable. Much like the CentOS/Ubuntu LTS ones, right?
Yes. (though - it is mainly Cygwin dependent in terms of new pkgs/features.)
Ok - so we move ahead with the Sphinx approach, keep updating there, export to pdf and upload the document wherever needed in order to keep the Win guide up to date.
Agreed ?
Peter Manev wrote:
Victor Julien wrote:
Windows, esp specific versions, should be quite stable. Much like the CentOS/Ubuntu LTS ones, right?
Yes. (though - it is mainly Cygwin dependent in terms of new pkgs/features.)
Ok - so we move ahead with the Sphinx approach, keep updating there, export to pdf and upload the document wherever needed in order to keep the Win guide up to date.
Agreed ?
Sure, sounds good to me.
- Target version changed from Documentation to TBD
- Tracker changed from Feature to Documentation
- Related to Documentation #5911: userguide: update & bring guide for installation on Windows to RtD added
Also available in: Atom
PDF