Re: [oi-dev] OI User documentation

2015-12-24 Thread Michael Kruger
On 12/22/2015 05:16 PM, Michael Kruger wrote: Hello all, My name is Michael Kruger and I would like to help contribute to the OI project by doing whatever I can towards improving the state of OI's end user documentation. I'm also willing to help with QA testing. While I don't have any developm

Re: [oi-dev] OI User documentation

2015-12-25 Thread Nikola M
On 12/24/15 09:40 PM, Michael Kruger wrote: On 12/22/2015 05:16 PM, Michael Kruger wrote: Hello all, My name is Michael Kruger and I would like to help contribute to the OI project by doing whatever I can towards improving the state of OI's end user documentation. I'm also willing to help with

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 03:40 AM, Nikola M wrote: On 12/24/15 09:40 PM, Michael Kruger wrote: On 12/22/2015 05:16 PM, Michael Kruger wrote: Hello all, My name is Michael Kruger and I would like to help contribute to the OI project by doing whatever I can towards improving the state of OI's end user do

Re: [oi-dev] OI User documentation

2015-12-25 Thread Aurélien Larcher
Hello Michael, welcome ! I would like to help contribute to the OI project by doing whatever I can >> towards improving the state of OI's end user documentation. I'm also >> willing to help with QA testing. >> > Thanks for the kind offer, this is great ! As Nikola pointed in his email setting up a

Re: [oi-dev] OI User documentation

2015-12-25 Thread Aurélien Larcher
> Having Mercurial and/or GIT locally (possibly with on Openindiana servers > has strong benefits to just using Github because at the end all sources and > final results must be distributed with the releases and it makes sense for > easy mirroring and distribution. > If it is put on GitHib it agai

Re: [oi-dev] OI User documentation

2015-12-25 Thread Andreas Wacknitz
Am 25.12.15 um 17:40 schrieb Aurélien Larcher: Having Mercurial and/or GIT locally (possibly with on Openindiana servers has strong benefits to just using Github because at the end all sources and final results must be distributed with the releases and it makes sense for easy mi

Re: [oi-dev] OI User documentation

2015-12-25 Thread Nikola M
On 12/25/15 05:40 PM, Aurélien Larcher wrote: Having Mercurial and/or GIT locally (possibly with on Openindiana servers has strong benefits to just using Github because at the end all sources and final results must be distributed with the releases and it makes sense for easy mir

Re: [oi-dev] OI User documentation

2015-12-25 Thread Aurélien Larcher
> > I expected to talk about user documentation in this thread so please refer > to the topic , we all know documentation ressurecting is hard but at least > let's stay into topic. > I wish you good luck with your endeavour and may prescriptions be implemented.

Re: [oi-dev] OI User documentation

2015-12-25 Thread Alexander Pyhalov
Hi, everyone, and Merry Christmas to all celebrating! Aurélien Larcher писал 25.12.2015 19:10: Following my previous comment, something to consider is to improve the OpenIndiana Handbook: http://wiki.openindiana.org/oi/OpenIndiana+Handbook I'd say. if you can engage more people in writing or

Re: [oi-dev] OI User documentation

2015-12-25 Thread Nikola M
On 12/25/15 07:52 PM, Alexander Pyhalov wrote: Hi, everyone, and Merry Christmas to all celebrating! Aurélien Larcher писал 25.12.2015 19:10: Following my previous comment, something to consider is to improve the OpenIndiana Handbook: http://wiki.openindiana.org/oi/OpenIndiana+Handbook I'd s

Re: [oi-dev] OI User documentation

2015-12-25 Thread Nikola M
On 12/25/15 07:31 PM, Aurélien Larcher wrote: I expected to talk about user documentation in this thread so please refer to the topic , we all know documentation ressurecting is hard but at least let's stay into topic. I wish you good luck with your endeavour and may prescriptions

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
Hi, could you also bring up this question on develo...@lists.illumos.org ML? I think it concerns not only OI, OmniTI and Joyent guys could also be interested in this. Hi Alexander, I agree this would be a good idea. Michael ___ oi-dev mailing list o

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 11:10 AM, Aurélien Larcher wrote: Hello Michael, welcome ! Thanks for the kind offer, this is great ! As Nikola pointed in his email setting up a repository and contribution guidelines for the existing documentation is an important task. I am not sure it is the most efficient way to

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 01:52 PM, Alexander Pyhalov wrote: I'd say. if you can engage more people in writing or supporting docs (perhaps, communicating with OmniOS and Joyeny folks), it worths resurrect old Sun docs from OpenSolaris days. But if you are the only one who works on documentation, updating OI

Re: [oi-dev] OI User documentation

2015-12-25 Thread Andreas Wacknitz
Am 25.12.15 um 21:54 schrieb Michael Kruger: On 12/25/2015 11:10 AM, Aurélien Larcher wrote: Hello Michael, welcome ! Thanks for the kind offer, this is great ! As Nikola pointed in his email setting up a repository and contribution guidelines for the existing documentation is an important task.

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 02:02 PM, Nikola M wrote: I think both of them have a place there, it is not the question weither one or another. it is important to write on the wiki and that is where people woud look first anyway. So it could be two tracks and being valuable for both big documentation, updated

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 03:58 PM, Andreas Wacknitz wrote: I agree getting docs into some kind of version control would be very helpful. I've previously worked with subversion, but would be more inclined to learn how to use GIT. Look here for an introduction: http://rypress.com/tutorials/git/index Reg

Re: [oi-dev] OI User documentation

2015-12-25 Thread Aurélien Larcher
Hello Michael, > > Yes, I would agree working on the wiki and handbook would be important. > After all, these are the very first things someone sees when vising the OI > website. > In this respect the website would need entry points to the Wiki and a page describing possible contributions. We can

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 03:40 AM, Nikola M wrote: -There was also docs-discuss mailing list that could be continued and made as new one on OI mailing lists for documentation use. Nice idea, but I doubt we're quite ready for something like that. Perhaps once DOC talk begin to detract from DEV talk, the

Re: [oi-dev] OI User documentation

2015-12-25 Thread Michael Kruger
On 12/25/2015 03:40 AM, Nikola M wrote: Documentation needs decisions weither it will replace "Opensolaris" wording with illumos or with Openindiana or both where appropriate. Also whether docs need to be separated in illumos ones that could be for all illumos distributions OS'es to share and

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/26/15 12:39 AM, Michael Kruger wrote: On 12/25/2015 03:40 AM, Nikola M wrote: -There was also docs-discuss mailing list that could be continued and made as new one on OI mailing lists for documentation use. Nice idea, but I doubt we're quite ready for something like that. Perhaps once

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/26/15 01:09 AM, Michael Kruger wrote: On 12/25/2015 03:40 AM, Nikola M wrote: Documentation needs decisions weither it will replace "Opensolaris" wording with illumos or with Openindiana or both where appropriate. Also whether docs need to be separated in illumos ones that could be for

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/25/15 10:10 PM, Michael Kruger wrote: On 12/25/2015 02:02 PM, Nikola M wrote: One can not replace big documentation with the Wiki and one can not replace Wiki's usability and versatility with XML/ODT/PDF documentation Once there are more contributors, then taking on larger projects (suc

Re: [oi-dev] OI User documentation

2015-12-26 Thread Alexander Pyhalov
Nikola M писал 26.12.2015 12:04: About blog posts, maybe having your own private blog that could have articles re-published on OI blog is the best option. Peopel can write all sort of things, but only those good enough and passign editorial decision would end up on Oi's blog. What do you think

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/25/15 04:55 PM, Michael Kruger wrote: Given how this documentation project is literally rising from the ashes of OpenSolaris, perhaps OpenIndiana should be renamed PheonixOS? It seems rather fitting as it describes the condition Illumos logo itself represent stylized Phoenix and it is

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/25/15 09:40 AM, Nikola M wrote: On 12/24/15 09:40 PM, Michael Kruger wrote: Found the official OpenSolaris docs. I think these are open source. http://files.if.undip.ac.id/index.php?dir=UNIXbox/OpenSolaris Perhaps we could import them into a GIT repo or something. That docs-20090715

Re: [oi-dev] OI User documentation

2015-12-26 Thread Andreas Wacknitz
Am 26.12.15 um 10:36 schrieb Nikola M: On 12/25/15 09:40 AM, Nikola M wrote: On 12/24/15 09:40 PM, Michael Kruger wrote: Found the official OpenSolaris docs. I think these are open source. http://files.if.undip.ac.id/index.php?dir=UNIXbox/OpenSolaris Perhaps we could import them into a GIT

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/26/15 10:14 AM, Alexander Pyhalov wrote: Nikola M писал 26.12.2015 12:04: About blog posts, maybe having your own private blog that could have articles re-published on OI blog is the best option. Peopel can write all sort of things, but only those good enough and passign editorial decis

Re: [oi-dev] OI User documentation

2015-12-26 Thread Nikola M
On 12/26/15 10:39 AM, Andreas Wacknitz wrote: I have just found this as the documentation reference. https://www.illumos.org/projects/documentation/wiki/Existing_OpenSolaris_documentation But all the links inside are dead (refer to opensolaris.org). I know, they could possibly be dug on ar

Re: [oi-dev] OI User documentation

2015-12-26 Thread Alan Coopersmith
On 12/26/15 01:36 AM, Nikola M wrote: I have just found this as the documentation reference. https://www.illumos.org/projects/documentation/wiki/Existing_OpenSolaris_documentation Which seems to need updates to point to http://illumos.org/books/ instead of the long dead hub.opensolaris.org.

Re: [oi-dev] OI User documentation

2015-12-26 Thread Alan Coopersmith
On 12/25/15 08:40 AM, Aurélien Larcher wrote: On the contrary since oi-userland, pkg and slim_source reside on Github, I do not see the point in reinventing the wheel or incur additional maintenance. Also https://github.com/rmustacc/illumos-docbooks since you're not the first to go there.

Re: [oi-dev] OI User documentation

2015-12-31 Thread Michael Kruger
On 12/26/2015 12:46 PM, Alan Coopersmith wrote: On 12/26/15 01:36 AM, Nikola M wrote: I have just found this as the documentation reference. https://www.illumos.org/projects/documentation/wiki/Existing_OpenSolaris_documentation Which seems to need updates to point to http://illumos.org/books/

Re: [oi-dev] OI User documentation

2015-12-31 Thread Alan Coopersmith
On 12/31/15 02:36 AM, Michael Kruger wrote: On 12/26/2015 12:46 PM, Alan Coopersmith wrote: On 12/26/15 01:36 AM, Nikola M wrote: I have just found this as the documentation reference. https://www.illumos.org/projects/documentation/wiki/Existing_OpenSolaris_documentation Which seems to need

Re: [oi-dev] OI User documentation

2016-01-07 Thread Damian Wojsław
On 26.12.2015 10:43, Nikola M wrote: On 12/26/15 10:14 AM, Alexander Pyhalov wrote: I think it's a good idea, but I'd avoid moderation step. We had http://planet.opensolaris.org/, http://planet.illumos.org/, http://blog.illumos.org/ (all seems to be dead now). I assume having similar blog a

Re: [oi-dev] OI User documentation

2016-01-07 Thread Michael Kruger
On 01/07/2016 05:04 AM, Damian Wojsław wrote: On the topic of re-using old OpenSolaris docs, I wouldn't mind, for one, to build on ZFS Administrator Guide. While differences are many, most of text would still be useful. Writing such a guide from start is a tedious task. I know, having started

Re: [oi-dev] OI User documentation

2016-01-09 Thread Aurélien Larcher
Hullo, speaking of planet, I deployed the stuff that was previously on > planet.oi.org. However, it never got used and there was lack of content > after few years. > > Having a blog agreggator is fine, it will be as good as the content it > agreggates. I can look into updating and redeploying it i