<div dir="ltr"><span class="gmail-"></span><br><span class="gmail-"></span><div class="gmail_extra"><div class="gmail_quote"><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote"><span class="gmail-">
</span>"At this point a member of the OpenIndiana Project docs team will review<br>
your changes."<br>
- This is what I was actually afraid of. Nothing goes past check of<br>
those who actually wrote it and mandate what stays in it and don't? So I<br>
don't suppose changes will be easy to go through.<br></blockquote><div><br></div><div>I think the idea is to actually make it easier to contribute: people may want feedback before pushing content and feel uncomfortable to do so otherwise.<br></div><div>The pull-request system allows to reviewing changes and get such feedback, therefore I see it as an improvement. <br></div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
Real docs are actually not suppose to be easy to go through with<br>
changes without review, yet I don't get any info who actually reviewed<br>
current articles in preparation before launching it.<br></blockquote><div><br></div><div>For the current content you can find a list of people involved in the README of the OpenIndiana oi-docs repository:<br><br><a href="https://github.com/OpenIndiana/oi-docs">https://github.com/OpenIndiana/oi-docs</a><br><br></div><div>Alexander and Adam also reviewed the content and I gave some minor feedback.<br><br></div><div>There are two "teams" in the Github OpenIndiana organization, "Developers" and "Docs" with appropriate credentials on the repositories.<br></div><div>People involved consist basically of a subset of these teams. <br></div><div><br></div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
I think I am pretty much well equipped myself to review them actually so<br>
I am here available for that.<br></blockquote><div><br></div><div>Great!<br> <br></div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
"Hosted by the OpenIndiana Documentation Team."<br>
I don't understand why docs site is not part of <a target="_blank" rel="noreferrer" href="http://openindina.org">openindina.org</a> styling,<br>
and represented as separate site.<br></blockquote><div><br></div><div>Styling is something that we should discuss. I am actually in the mood for a refresh of the website and docs styles altogether.<br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
What is the so called 'docs team' that is supposedly 'hosting'<br>
Openindiana site (shouldn't openindiana site be hosted by openindiana<br>
itself and not third party?)<br></blockquote><div><br></div><div>The docs team is the Github team, the "hosting" wording is perhaps misleading.<br> <br></div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
Actually that site looks like replacing many contents of Openindiana.org<br>
site itself, too so I am pretty much fully confused of the need for it's<br>
existence in such form.<br>
Many parts of it looks better fitting on <a target="_blank" rel="noreferrer" href="http://openindiana.org">openindiana.org</a> site itself and<br>
Wiki (or are just repeating the contents), while truly some of it is<br>
better left on separate place.<br></blockquote><div><br><div>I am not sure about that... To me the website should serve rather
dynamic content (news, announcement, ...) and provide entry points to
more substantial documentation. You can see the website as the headlines
and a table of contents with introductory contents: a frontend
basically.<br></div>Some level of duplication is expected as
information presented briefly on the website may be extended in the user
documentation and on the wiki.<br> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
So I recommend for <a target="_blank" rel="noreferrer" href="http://www.openindiana.org">www.openindiana.org</a> site integration, both with style<br>
and look and feel and to distingush that not everything that comes to<br>
the mind has a place to be put in Documentation, but on Wiki.<br></blockquote><div><br></div>The style is something that is already under consideration.<br></div><div class="gmail_quote">At least we discussed it since Spring.<br><br></div><div class="gmail_quote">About the Wiki, see the note below: this is something we already discussed and the "work in progress" part of OpenIndiana Docs includes refining its perimeter.<br></div><div class="gmail_quote"><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
One don't need to learn nor use Git nor make accounts on separate sites,<br>
if using Openindiana Wiki.<br>
Another problem is actually depending on Github and organizing hierarchy<br>
of "pasting issue" there instead on openindiana infrastructure,<br>
therefore creating separate managerial structure and Github is also not<br>
available to all the countries in the world.<br></blockquote><div><br></div><div>I was not aware of this issue.<br> <br></div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
I think most of these issues could be resolved by doing things more in<br>
public, on mailing list in preparation, development, planning and<br>
working period,<br>
instead of using private mailing lists, private consultations and<br>
surfacing with what seems unchangeable "already decided" things.<br></blockquote><div><br></div><div>As we discussed in the past: you have to start somewhere.<br></div><div>People may come up with proofs of concept and ask for feedback until the idea has matured enough to be proposed to the community.<br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<span class="gmail-"><br>
</span>You can't decide what stays or leaves Wiki by yourself, that is the<br>
process of many people.<br>
I ask not to cannibalize it's content, but to contribute to it.<br>
I agree on other stands about one not being replacement for another and<br>
vice-versa.<br></blockquote><div><br></div><div>Following from your earlier comments, I asked Adam to add this line so as to make clear that this project is about *User* documentation and not *Development* notes but you managed to take it the wrong way ;)<br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<br>
<br>
If anyone thinks that Docs are easy to be "rolled released" that is<br>
conflicting with what Documentation is.<br>
Documentation is refreshed and can relate to the release and Openindiana<br>
currently does not have releases to refer to.<br>
Actually easily and fast streamlining changes to articles, calling it<br>
documentation, is what should be avoided<br>
-IF documentation quality is the goal and mistakes are to be avoided.<br>
There is an alternative of constantly checking and reviewing every<br>
possible change and that seems time consuming but unavoidable in<br>
presented model.<br></blockquote><div><br></div><div>Considering the available manpower we need a lightweight process, I think the presented solution is satisfactory for now.<br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">
<div class="gmail-HOEnZb"><div class="gmail-h5"><br>
<br>
______________________________<wbr>_________________<br>
oi-dev mailing list<br>
<a href="mailto:oi-dev@openindiana.org">oi-dev@openindiana.org</a><br>
<a target="_blank" rel="noreferrer" href="https://openindiana.org/mailman/listinfo/oi-dev">https://openindiana.org/<wbr>mailman/listinfo/oi-dev</a></div></div></blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><font style="font-family:courier new,monospace" size="1">---<br>Praise the Caffeine embeddings<br></font></div></div></div></div>
</div></div>