On 15.4.19. 14:14, Bryan Horstmann-Allen wrote:
>> On 2019-04-14 00:28:51, Bryan Horstmann-Allen wrote:
>>
>> There's an issue with Confluence, and the wiki will be off for a bit.
>>
>> Will try to keep folks apprised as I dig into it tomorrow.
> Given the issues we were having with Confluece, Josh went ahead and deployed
> the mkdocs work I did a while ago -- after cleaning it up a bunch. Thanks to

This is rather unfortunate,
Wiki looks nice, and there is the need to distinguish between Wiki
content ( fast way to publish changes without the need for 'approval'
but ability to include other's changes afterwards) , Web site content
management , fast 'docs' as fast derivative and proper 'Documentation'
that is none of the three.
It is very hard to look at too wide presented texts and scroll forever
loosing content while looking at it.

And also loosing freedom and ability to fast write something to the
Wiki, that is more suitable to developers who want to explain something
fast, without possibly long approval times of git-based web site publishing.

Also Wiki content and locations is by now indexed in web crawlers
(Google etc.) and loosing those links that would die, would loose web
site location (illumos.org) it's place on the web search results (when
links indexed are not working)
Not to mention what would people think when links to illumos.org
massively don't work anymore.

I don't get what problems with Confluence too.
There is certainly  the place for Wiki type of content beside others.

> Josh for that work, and wiedi for working on the theme last year!
>
> https://illumos.org/docs/
>
> Josh also added a number of redirects from the base wiki URLs to their newer
> static counterparts.
>
> PRs or bug reports can be submitted in the GH repo:
>
> https://github.com/illumos/docs/
>
> Some notes on helping with the docs are here (and we definitely need help!)
>
> https://illumos.org/docs/contributing/docs/
>
> Cheers.

------------------------------------------
illumos: illumos-discuss
Permalink: 
https://illumos.topicbox.com/groups/discuss/T6b2720ad4fedda8d-M32213fea56c0e700e0845907
Delivery options: https://illumos.topicbox.com/groups/discuss/subscription

Reply via email to