Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Nikola M

On 06/16/16 05:48 PM, Aurélien Larcher wrote:
I think you should write an extensive documentation about contribution 
process so that everyone can benefit from your invaluable experience. 
It is a pity such amount of knowledge is diluted and scattered across 
numerous email threads.


Yes, let's be very extensive at the moment:

Use the Oi Wiki. :)
Fullstop.




___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Nikola M

On 06/16/16 12:04 AM, Dmitry Kozhinov wrote:

About 8% of visits are from mobile devices.
For instance 7% come from 'SunOS'.


Thank you for the information.


Please hit "reply" button on your mail client, to stay in-line with 
answers,

otherwise it creates a new topic :)

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Nikola M

On 06/15/16 07:36 PM, Aurélien Larcher wrote:


À mer. juin 15 05:56:21 2016 GMT+0200, Nikola M a écrit :


It is interesting information for OI website, regarding visitors etc,

About 8% of visits are from mobile devices.
For instance 7% come from 'SunOS'.



Thanks for the info.


___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Aurélien Larcher
On Thu, Jun 16, 2016 at 5:39 PM, Nikola M  wrote:

> On 06/16/16 02:41 AM, Michael Kruger wrote:
>
>> Hi Alexander,
>> I copied what you wrote above and created a github issue:
>>
>
> Process of contribution and review can't go through your private repo and
> you received previous issues on this Mailig  List as the only place for
> them to receive for now.
>
> Within this issue I referenced several additional issues, created to
>> address these points individually.
>>
>
> Whatever you put on your own site, it's your thing.
> Everything related to Oi is on OI's site
> and "process" you prescribed putting you on top for review is not
> acceptable.
>
> One can't review hes' own writing by himself and you clearly misuse word
> "Docs", because what you write are your articles and I don't know how many
> times I need to repeat this?


I think you should write an extensive documentation about contribution
process so that everyone can benefit from your invaluable experience.
It is a pity such amount of knowledge is diluted and scattered across
numerous email threads.



>
>
>
> ___
> openindiana-discuss mailing list
> openindiana-discuss@openindiana.org
> http://openindiana.org/mailman/listinfo/openindiana-discuss
>



-- 
---
Praise the Caffeine embeddings
___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Nikola M

On 06/15/16 11:31 AM, Udo Grabowski (IMK) wrote:

On 15/06/2016 05:56, Nikola M wrote:

On 06/14/16 04:58 PM, Dmitry Kozhinov wrote:

I don't Use iPhone, I use Openindiana.


It is interesting information for OI website, regarding visitors etc, 
yes.

Website is made for visitors, yes, and it is made for me as OI user.
But It doesn't mean site needs to be ugly and unusable on OI desktop 
because of
influx of mobile users. Main concern is how it looks like for OI 
users, second

concern is how it looks for others.


Since the new version of the docs is coded now, it should be


These are not OI docs.
This is private makruger site that is with he's 2 unrenewed articles.

This can't end up on OI site for having clear organizational issues of 
self-proclaiming.



possible to add some javascript that detects users device
parameters and render the sites accordingly. There are
a lot of examples and ready to use code how to do that in javascript.
I think that should also be the goal of the new version to facilitate
dynamical rendering serving best the presently connected device.

I really hate those projects where that is fixed based on the
"majority" with a "standard" viewing device (like it happened


I currently have zero care about how it is viewed from iPhone.

illumos targets x86 and Oi has i's desktop and if OI web site will be 
more visible to other platforms, it is unrelated to Makruger's private site.



in Gnome3, Unity, and the like). The world has moved on to
modern dynamic technics, and the new docs project should use
those goodies to render dynamically from a lightweight coded
docs repository which Michael is developing now.


Those are not docs.
Docs are made over long time from articles and best practices.


___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-16 Thread Nikola M

On 06/16/16 02:41 AM, Michael Kruger wrote:

Hi Alexander,
I copied what you wrote above and created a github issue:


Process of contribution and review can't go through your private repo 
and you received previous issues on this Mailig  List as the only place 
for them to receive for now.


Within this issue I referenced several additional issues, created to 
address these points individually.


Whatever you put on your own site, it's your thing.
Everything related to Oi is on OI's site
and "process" you prescribed putting you on top for review is not 
acceptable.


One can't review hes' own writing by himself and you clearly misuse word 
"Docs", because what you write are your articles and I don't know how 
many times I need to repeat this?



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Michael Kruger

On 06/15/2016 05:31 AM, Udo Grabowski (IMK) wrote:



Since the new version of the docs is coded now, it should be
possible to add some javascript that detects users device
parameters and render the sites accordingly. There are
a lot of examples and ready to use code how to do that in javascript.
I think that should also be the goal of the new version to facilitate
dynamical rendering serving best the presently connected device.

I really hate those projects where that is fixed based on the
"majority" with a "standard" viewing device (like it happened
in Gnome3, Unity, and the like). The world has moved on to
modern dynamic technics, and the new docs project should use
those goodies to render dynamically from a lightweight coded
docs repository which Michael is developing now.


Hello Udo,

The new site uses the Bootswatch 'Spacelab' theme which is derived from 
Bootstrap 3. Bootstrap is a mobile first framework. From the ground up 
it was designed to be responsive and dynamically alter it's appearance 
to best suite the device used to view the page.


It's doing exactly what you describe, which is exactly what we need.

http://getbootstrap.com/

https://bootswatch.com/spacelab/

Thank you for your comments,

Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Michael Kruger

On 06/15/2016 04:37 AM, Alexander Pyhalov wrote:


Hi, Michael.

Let's consider things which should be done to make documentation site
official:
- provide quick links to the latest OpenSolaris 2009.06 documentation
collection, hosted on github or our servers;
- move all actual and relevant content of current handbook to new version;
- review new handbook content to avoid actual errors;
- move repository to OI organization;
- make look and feel of http://www.openindiana.org/ and documentation
site similar;
- provide links to illumos documentation, open zfs documentation where
necessary.

I welcome other ideas and suggestions, except "let's don't touch OI
docs", as they just don't exist now...


Hi Alexander,

I copied what you wrote above and created a github issue:

https://github.com/makruger/website-2.0/issues/49

Within this issue I referenced several additional issues, created to 
address these points individually.


If you or anyone else has anything else to add, feel free to add a 
comment to the issue, or reply back here.


Thank you for your suggestions,

Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Dmitry Kozhinov

About 8% of visits are from mobile devices.
For instance 7% come from 'SunOS'.


Thank you for the information.

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Aurélien Larcher


À mer. juin 15 05:56:21 2016 GMT+0200, Nikola M a écrit :
> On 06/14/16 04:58 PM, Dmitry Kozhinov wrote:
> >> I don't Use iPhone, I use Openindiana.
> >
> > The website is not made for you, it's made for visitors. Can you 
> > please take a look at openindiana.org website stats and tell us what 
> > OS/device visitors use most?
> 
> It is interesting information for OI website, regarding visitors etc,

About 8% of visits are from mobile devices.
For instance 7% come from 'SunOS'.
 
> yes.  Website is made for visitors, yes, and it is made for me as OI user.
> But It doesn't mean site needs to be ugly and unusable on OI desktop 
> because of influx of mobile users. Main concern is how it looks like for 
> OI users, second concern is how it looks for others. And OI does not run 
> on mobile phones.
> People seeking information most certainly will use OI desktop (or other 
> desktops), because of general illumos distro orientation toward server 
> use (that have a DE as an extension).
> There are now also other smaller illumos distros that also ship desktop 
> (tribblix/SVR4, XStreamos/IPS), with OI being well known and most used. 
> And they also don't run on mobile phones.
> There are benefits of OI site to be rendered nice on Mobile platforms, 
> yes, but I won't hold my breath of it's big usability pressure, 
> regarding target audience for site and distribution as a whole.
> 
> Also it is another topic actually , where personal site like this can be 
> viewed as an inspiration if there are (better) articles.
> Quality of writing and is factual state are that matters.
> "Docs" are made by closely following actual changes in software and 
> documenting them. It is a dull thing, actually.. (plus producing Pdfs 
> and Html representation at the end).
> They are the final stage of a long process of Blogs, articles, writings, 
> documenting changes, boiling manuals over tim to actual documentation 
> form. it is actually something people can reference and that includes 
> best practices and errors or mistakes in it can actually cost people 
> lives and jobs..
> Writing on Wiki allows to easily contribute articles if one have actual 
> need to articulate something hes/she finds interesting for others.
> 
> 
> ___
> openindiana-discuss mailing list
> openindiana-discuss@openindiana.org
> http://openindiana.org/mailman/listinfo/openindiana-discuss
>

-- 
Thanks for sailing Jolla :)
___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Aurélien Larcher
On Wed, Jun 15, 2016 at 11:31 AM, Udo Grabowski (IMK)  wrote:

> On 15/06/2016 05:56, Nikola M wrote:
>
>> On 06/14/16 04:58 PM, Dmitry Kozhinov wrote:
>>
>>> I don't Use iPhone, I use Openindiana.

>>> 
>> It is interesting information for OI website, regarding visitors etc, yes.
>> Website is made for visitors, yes, and it is made for me as OI user.
>> But It doesn't mean site needs to be ugly and unusable on OI desktop
>> because of
>> influx of mobile users. Main concern is how it looks like for OI users,
>> second
>> concern is how it looks for others.
>>
>
> Since the new version of the docs is coded now, it should be
> possible to add some javascript that detects users device
> parameters and render the sites accordingly. There are
> a lot of examples and ready to use code how to do that in javascript.
> I think that should also be the goal of the new version to facilitate
> dynamical rendering serving best the presently connected device.
>

Yes, nowadays most websites use so-called "responsive" themes.
The Wordpress theme is responsive since the refresh and so does Michael's
demo.
You can just resize your browser window to check that the menu adapts to
the width or even use the Firefox tool to switch between rendering
resolution.


>
> I really hate those projects where that is fixed based on the
> "majority" with a "standard" viewing device (like it happened
> in Gnome3, Unity, and the like). The world has moved on to
> modern dynamic technics, and the new docs project should use
> those goodies to render dynamically from a lightweight coded
> docs repository which Michael is developing now.
> --
> Dr.Udo Grabowski   Inst.f.Meteorology & Climate Research IMK-ASF-SAT
> http://www.imk-asf.kit.edu/english/sat.php
> KIT - Karlsruhe Institute of Technology   http://www.kit.edu
> Postfach 3640,76021 Karlsruhe,Germany T:(+49)721 608-26026 F:-926026
>
>
> ___
> openindiana-discuss mailing list
> openindiana-discuss@openindiana.org
> http://openindiana.org/mailman/listinfo/openindiana-discuss
>



-- 
---
Praise the Caffeine embeddings
___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Udo Grabowski (IMK)

On 15/06/2016 05:56, Nikola M wrote:

On 06/14/16 04:58 PM, Dmitry Kozhinov wrote:

I don't Use iPhone, I use Openindiana.


It is interesting information for OI website, regarding visitors etc, yes.
Website is made for visitors, yes, and it is made for me as OI user.
But It doesn't mean site needs to be ugly and unusable on OI desktop because of
influx of mobile users. Main concern is how it looks like for OI users, second
concern is how it looks for others.


Since the new version of the docs is coded now, it should be
possible to add some javascript that detects users device
parameters and render the sites accordingly. There are
a lot of examples and ready to use code how to do that in javascript.
I think that should also be the goal of the new version to facilitate
dynamical rendering serving best the presently connected device.

I really hate those projects where that is fixed based on the
"majority" with a "standard" viewing device (like it happened
in Gnome3, Unity, and the like). The world has moved on to
modern dynamic technics, and the new docs project should use
those goodies to render dynamically from a lightweight coded
docs repository which Michael is developing now.
--
Dr.Udo Grabowski   Inst.f.Meteorology & Climate Research IMK-ASF-SAT
http://www.imk-asf.kit.edu/english/sat.php
KIT - Karlsruhe Institute of Technology   http://www.kit.edu
Postfach 3640,76021 Karlsruhe,Germany T:(+49)721 608-26026 F:-926026

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-15 Thread Alexander Pyhalov

On 06/12/16 04:56 PM, Michael Kruger wrote:

Hello All,

I am happy to announce further development of the OpenIndiana Docs
static HTML website concept. This latest demonstration site uses the
MkDocs content authoring and static website generation framework. MkDocs
uses Markdown as the text markup used for content authoring.

The website theme remains the same (Bootswatch/Spacelab). Supported are
in-line HTML elements, as well as Font Awesome HTML elements.

Please go have a look:

Website: http://makruger.github.io/website-2.0/

GitHub repository: https://github.com/makruger/website-2.0



Hi, Michael.

Let's consider things which should be done to make documentation site 
official:
- provide quick links to the latest OpenSolaris 2009.06 documentation 
collection, hosted on github or our servers;

- move all actual and relevant content of current handbook to new version;
- review new handbook content to avoid actual errors;
- move repository to OI organization;
- make look and feel of http://www.openindiana.org/ and documentation 
site similar;
- provide links to illumos documentation, open zfs documentation where 
necessary.


I welcome other ideas and suggestions, except "let's don't touch OI 
docs", as they just don't exist now...

--
Best regards,
Alexander Pyhalov,
system administrator of Southern Federal University IT department

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-14 Thread Nikola M

On 06/14/16 04:58 PM, Dmitry Kozhinov wrote:

I don't Use iPhone, I use Openindiana.


The website is not made for you, it's made for visitors. Can you 
please take a look at openindiana.org website stats and tell us what 
OS/device visitors use most?


It is interesting information for OI website, regarding visitors etc, 
yes.  Website is made for visitors, yes, and it is made for me as OI user.
But It doesn't mean site needs to be ugly and unusable on OI desktop 
because of influx of mobile users. Main concern is how it looks like for 
OI users, second concern is how it looks for others. And OI does not run 
on mobile phones.
People seeking information most certainly will use OI desktop (or other 
desktops), because of general illumos distro orientation toward server 
use (that have a DE as an extension).
There are now also other smaller illumos distros that also ship desktop 
(tribblix/SVR4, XStreamos/IPS), with OI being well known and most used. 
And they also don't run on mobile phones.
There are benefits of OI site to be rendered nice on Mobile platforms, 
yes, but I won't hold my breath of it's big usability pressure, 
regarding target audience for site and distribution as a whole.


Also it is another topic actually , where personal site like this can be 
viewed as an inspiration if there are (better) articles.

Quality of writing and is factual state are that matters.
"Docs" are made by closely following actual changes in software and 
documenting them. It is a dull thing, actually.. (plus producing Pdfs 
and Html representation at the end).
They are the final stage of a long process of Blogs, articles, writings, 
documenting changes, boiling manuals over tim to actual documentation 
form. it is actually something people can reference and that includes 
best practices and errors or mistakes in it can actually cost people 
lives and jobs..
Writing on Wiki allows to easily contribute articles if one have actual 
need to articulate something hes/she finds interesting for others.



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-14 Thread Dmitry Kozhinov

I don't Use iPhone, I use Openindiana.


The website is not made for you, it's made for visitors. Can you please 
take a look at openindiana.org website stats and tell us what OS/device 
visitors use most?


___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0 (Now with HTTPS & Travis-CI)

2016-06-13 Thread Nikola M

On 06/14/16 08:32 AM, Aurélien Larcher wrote:

We have tons of articles and people on Openindiana Wiki. And to best
abilities it is current..
We already have contribution process.
And we need people writing on wiki.openindiana.org and NOT on your private
place...

Stop using "we" please, your opinion is very personal and does not
represent the project in any way.
People are welcome to bring new ideas and concepts.

You are right about one thing: the repository should certainly live on
OpenIndiana's Github space.


Using We because it is true. We all have a Openindiana Wiki and we are 
all (everyone on lis) is free to contribute to it and it is very easy to.


No "hierarchy" of that sort is needed right now that article-git process 
would imply.
I don't see Makruger as right person for a position to mandate 
processes, because ideas of exclusive process is antisocial.



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0 (Now with HTTPS & Travis-CI)

2016-06-13 Thread Aurélien Larcher
On Tue, Jun 14, 2016 at 7:00 AM, Nikola M  wrote:
> On 06/13/16 09:29 PM, Michael Kruger wrote:
>>
>> Update on this.
>>
>> We're fully automated with continuous integration (via Travis-ci) and have
>> enabled HTTPS. And just today added a new script that checks for broken
>> URL's.
>
>
> Please market private blogs elsewhere. And stop calling your article site
> "Docs" and OI docs it is not.
>
>> The updated site URL is: https://makruger.github.io/website-2.0/
>>
> We have Openindiana docs to refresh out of Opensolaris docs, not write
> everything new(!), it is not sane...
> We have Wiki on wiki.openindiana.org to contribute, with one-click
> process...
>
> Please don't distract Openindiana project with your private site, privately
> controlled only by you.
> I dont' recognize your writing quality as any reason to trust you nor the
> one to mandate anything.
>
> Any contributions to your site will not be accepted to Openindiana unless
> _articles_ going through OI Wiki.
>
> We are Inclusive project, not exclusive as you would like (!) and I don't
> except any dictatorship you are imposing through your site and private
> Github.
>
> Writings are not articles.
> Articles are not Docs.
> Docs are not Code.
> OI site is not for you to play games with such a ugly thing.
>>
>>
>> For anyone wishing to give contributing a test run, here's a direct link
>> to the "Getting Started" doc:
>>
>> https://makruger.github.io/website-2.0/contrib/getting-started/
>
>
> Please stop advertising your private projects outside Openindiana.
> You are behaving contrary to interest of Openindiana.
> Youa are actively defying open community process in Openindiana by
> redefining it to yourself at the top... and that is NOT accepted.
>
> We have tons of articles and people on Openindiana Wiki. And to best
> abilities it is current..
> We already have contribution process.
> And we need people writing on wiki.openindiana.org and NOT on your private
> place...
>
> You are banging the wrong dooor for the last 6 months and I am sick of it
> already.

Stop using "we" please, your opinion is very personal and does not
represent the project in any way.
People are welcome to bring new ideas and concepts.

You are right about one thing: the repository should certainly live on
OpenIndiana's Github space.

>
>
>
> ___
> openindiana-discuss mailing list
> openindiana-discuss@openindiana.org
> http://openindiana.org/mailman/listinfo/openindiana-discuss



-- 
---
Praise the Caffeine embeddings

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0 (Now with HTTPS & Travis-CI)

2016-06-13 Thread Nikola M

On 06/14/16 07:00 AM, Nikola M wrote:


Please market private blogs elsewhere. And stop calling your article 
site "Docs" and OI docs it is not.


Just to make sure I am not misunderstood, I very much like private sites 
and blogs with OI-related articles.

Please DO post about them existing for new ideas and articles.

That said, this in-topic is obviously example of bad behaving one, that 
wants to take over the world..



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0 (Now with HTTPS & Travis-CI)

2016-06-13 Thread Nikola M

On 06/13/16 09:29 PM, Michael Kruger wrote:

Update on this.

We're fully automated with continuous integration (via Travis-ci) and 
have enabled HTTPS. And just today added a new script that checks for 
broken URL's.


Please market private blogs elsewhere. And stop calling your article 
site "Docs" and OI docs it is not.



The updated site URL is: https://makruger.github.io/website-2.0/

We have Openindiana docs to refresh out of Opensolaris docs, not write 
everything new(!), it is not sane...
We have Wiki on wiki.openindiana.org to contribute, with one-click 
process...


Please don't distract Openindiana project with your private site, 
privately controlled only by you.
I dont' recognize your writing quality as any reason to trust you nor 
the one to mandate anything.


Any contributions to your site will not be accepted to Openindiana 
unless _articles_ going through OI Wiki.


We are Inclusive project, not exclusive as you would like (!) and I 
don't except any dictatorship you are imposing through your site and 
private Github.


Writings are not articles.
Articles are not Docs.
Docs are not Code.
OI site is not for you to play games with such a ugly thing.


For anyone wishing to give contributing a test run, here's a direct 
link to the "Getting Started" doc:


https://makruger.github.io/website-2.0/contrib/getting-started/


Please stop advertising your private projects outside Openindiana.
You are behaving contrary to interest of Openindiana.
Youa are actively defying open community process in Openindiana by 
redefining it to yourself at the top... and that is NOT accepted.


We have tons of articles and people on Openindiana Wiki. And to best 
abilities it is current..

We already have contribution process.
And we need people writing on wiki.openindiana.org and NOT on your 
private place...


You are banging the wrong dooor for the last 6 months and I am sick of 
it already.



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


[OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0 (Now with HTTPS & Travis-CI)

2016-06-13 Thread Michael Kruger

Update on this.

We're fully automated with continuous integration (via Travis-ci) and 
have enabled HTTPS. And just today added a new script that checks for 
broken URL's.


The updated site URL is: https://makruger.github.io/website-2.0/

Currently we have 3 contributors, but we definitely will need additional 
help as the momentum continues to build.


For anyone wishing to give contributing a test run, here's a direct link 
to the "Getting Started" doc:


https://makruger.github.io/website-2.0/contrib/getting-started/

More to come


Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-13 Thread Nikola M

On 06/12/16 10:17 PM, Michael Kruger wrote:

On 06/12/2016 03:59 PM, Nikola M wrote:


So doesn't look nice , not solving any issue and not needing any
"Organizing" into "Roles" right now, thank you.


Nikolam,

All criticisms set aside, you have to admit this new site looks simply 
fabulous on an iPhone.


I don't Use iPhone, I use Openindiana.

For your personal site and blog it may be, but not for OI site by any means.

It still look awfull as web page (juck), not to mention not by any means 
integrable to OI site.. .




Try that sometime with the OI wiki.


OI Wiki is here to stay. Many articles and content on it and many 
contributors welcome.

Plus it is more democratic then personal GIT.

You are welcome to write articles and put them wherever you want , yet 
not going to push your site to OI at all.


There are improvements, you separated your writings etc from articles, 
that is good, you also made it use less empty space between lines, that 
is good (neds even less space between), you still think you are one and 
only who knows everything, not good :)


i always welcome people making their blogs and personal sites and 
writing whatever they want on OI and illumos. It could be goot place to 
seek from inspiration for Wiki and yes, docs in the future.


Your personal site is welcome but that's it.
I suggest working on articles not on making world a better place. :)


___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Michael Kruger

On 06/12/2016 03:59 PM, Nikola M wrote:


So doesn't look nice , not solving any issue and not needing any
"Organizing" into "Roles" right now, thank you.


Nikolam,

All criticisms set aside, you have to admit this new site looks simply 
fabulous on an iPhone.


Try that sometime with the OI wiki.

Michael



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Nikola M

On 06/12/16 06:27 PM, Jerry Kemp wrote:

Wow Michael,

That's awesome.  Thank you.


It has so many problems and is so ugly and doesn't fit to OI.org site 
and we have a Wiki for an article review before entering Site.
It is interesting maybe but not awesome by any mean and doesn't fit OI 
needs at the moment (including segregation of contributors at the moment).



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Nikola M

On 06/12/16 03:56 PM, Michael Kruger wrote:

Website: http://makruger.github.io/website-2.0/


Still too many empty space between lines, uncondesed and widen without need.
More info on less space.

All texts on "Notes" seems like your private writings that are good to 
be moved on some personal blog (and discussed there or as topics 
discussed on ML.


Docs are not code!
Articles are not Docs.

Separating people to "reviewers" (gods) and "the rest" is not good at 
the moment, regarding number of people.
"Code of conduct not needed (!) , and absolutely not part of any docs 
movement atm. We are base on INCLUSION of people and not Exclusive... 
Presenting hierarchy not needed because administrative moves does not 
help doing the work atm.


Wiki is there to put articles on. Some of your writings on "Notes could 
be conidered for a Wiki material (if not already on Wiki, that is very 
possible)..

Git presented is managed by single person and not form inside OI.

No space on site for such a large overwhelming web page like this. 
Jumping to separate site like this from OI.org site is confusing to people.


** Path to articles is like this:   Whatever -> Personal blogs etc - > 
Wiki -> Redaction -> Site.**


No publishing on Openindiana site from your private repo without this 
review path.


This is only known to me "docs" pages that actually does not include 
docs, but "handbook" that _we already have on Wiki_.


And at the end, it does not looks nice, if it too pompously separate to 
separated site ,
does not conform with Openindiana.org site look and feel and is 
therefore unsuitable to put on Openindian.org site, anywhere, any time 
soon.


Very little actual content (articles are not docs),
lack Opensolaris docs to PDF and Html that "Docs" should actually solve.
So it actually doesn't sovle much problems right now.

I think That your writings could be reviewed for Wiki inclusion but 
after that it is interesting what is the use case of your site an process?


So doesn't look nice , not solving any issue and not needing any 
"Organizing" into "Roles" right now, thank you.



___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Michael Kruger

On 06/12/2016 12:27 PM, Jerry Kemp wrote:


Wow Michael,

That's awesome.  Thank you.

Jerry


Hi Jerry, it gets even better

This afternoon we automated everything with Travis-CI. Now upon commit 
the site automatically runs through a series of validation tests. If 
everything passes, the site is automatically built and deployed to 
GitHub pages.


If you or anyone else has any suggestions for improvement, we're happy 
to listen. Simply open an issue on Github:


https://github.com/makruger/website-2.0/issues

Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


Re: [OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Jerry Kemp

Wow Michael,

That's awesome.  Thank you.

Jerry


On 06/12/16 08:56 AM, Michael Kruger wrote:

Hello All,

I am happy to announce further development of the OpenIndiana Docs static HTML
website concept. This latest demonstration site uses the MkDocs content
authoring and static website generation framework. MkDocs uses Markdown as the
text markup used for content authoring.

The website theme remains the same (Bootswatch/Spacelab). Supported are in-line
HTML elements, as well as Font Awesome HTML elements.

Please go have a look:

Website: http://makruger.github.io/website-2.0/

GitHub repository: https://github.com/makruger/website-2.0


Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss


[OpenIndiana-discuss] OpenIndiana Docs - Demo 2.0

2016-06-12 Thread Michael Kruger

Hello All,

I am happy to announce further development of the OpenIndiana Docs 
static HTML website concept. This latest demonstration site uses the 
MkDocs content authoring and static website generation framework. MkDocs 
uses Markdown as the text markup used for content authoring.


The website theme remains the same (Bootswatch/Spacelab). Supported are 
in-line HTML elements, as well as Font Awesome HTML elements.


Please go have a look:

Website: http://makruger.github.io/website-2.0/

GitHub repository: https://github.com/makruger/website-2.0


Michael

___
openindiana-discuss mailing list
openindiana-discuss@openindiana.org
http://openindiana.org/mailman/listinfo/openindiana-discuss