illumos / docs Goto Github PK

Right now to get the closed-bins on OI you need to install the illumos-closed package as well which is missing from the list of packages.

As we're moving to gcc10 shadow compiler, we should update the docs.

https://illumos.github.io/docs/community/

https://wiki.illumos.org/display/illumos/illumos+Jobs

Presumably some stuff has changed in the last year since this was reviewed. Pull things over.

There is a dead link on the https://illumos.org/docs/about/history/ page:
[silently closed the gate](http://sstallion.blogspot.com.au/2010/08/opensolaris-is-dead.html): this blog is not available anymore, but can be found on archive.org: https://web.archive.org/web/20170904093634/http://sstallion.blogspot.nl/2010/08/opensolaris-is-dead.html

Review Confluence page history and note at bottom of ported pages.

https://illumos.github.io/docs/community/events/

https://illumos.github.io/docs/user-guide/

While it can be and is used in any nearly situation where a UNIX-type server is needed, illumos excels at storage applications, large multi-tenant systems, and other cloud-centric uses.

used in any nearly situation -> used in nearly any situation

https://illumos.github.io/docs/user-guide/bugs/

Examples:

• https://www.openbsd.org/report.html
• https://www.freebsd.org/support.html
• https://www.freebsd.org/doc/en_US.ISO8859-1/articles/problem-reports/
• https://www.freebsd.org/doc/en_US.ISO8859-1/articles/pr-guidelines/

On https://www.illumos.org/docs/about/logo/ the link to download the "Zip of all logos" no longer works.
Seems like it was part of the older smartos wiki.

Luckily archive.org still has a copy at https://web.archive.org/web/20161118032732/https://wiki.smartos.org/download/attachments/753667/illumos_logos.zip

Do we have a place for such things? Should this live in this repo or somewhere else?

https://illumos.github.io/docs/about/distro/

Pull over the comparison matrix?

https://illumos.github.io/docs/about/features/

On the page https://illumos.org/docs/contributing/qds/ is a link to a hub.opensolaris (down below). This is a dead link since this domain is not resolving anymore.
Maybe we can provide a copy ourself on the documentation (if permissions are ok) or refer to another link where this is hosted now.

https://illumos.github.io/docs/about/faq/

Remove any old/irrelevant content. What's missing?

Examples:

https://www.openbsd.org/faq/
https://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/

https://illumos.github.io/docs/user-guide/build/

http://illumos.github.io/docs/about/who/#collaboration

https://illumos.github.io/docs/community/videos/

Subject line says it all. Today the first URL 404s, which is not good.

Bonus points if https://security.illumos.org/ goes to the docs/security page as well.

The leadership.md file contains word repetition:

In general there there should be no noise from any check,

's/there there/there/'

https://illumos.github.io/docs/contributing/

Probably also want to break the content here into only an overview + actual contribution pages.

FBSD port. cf https://wiki.illumos.org/display/illumos/Boot+Loader

https://illumos.github.io/docs/about/features/

https://wiki.illumos.org/display/illumos/Sub-Projects

Update docs for IPD 4 manual renaming

https://illumos.github.io/docs/contributing/qds/

Cleanup formatting/defs.

If we use a term in a page that people may not be familiar with, make sure there's a terminology block that defines it.

Nothing massive, akin to https://www.freebsd.org/news/newsflash.html

https://illumos.github.io/docs/security/

Via Udo Grabowski on developer@illumos

Need to fix the theme to differentiate.

via John Hardward on developer@illumos

However, I am color blind and there is not enough contrast between the
color for the URL links and whatever color the background is.  The
unhilighted URL links blend into the background to become nearly
invisible.  1/5 males are color blind, usually to greens.

My advice is Black background & White text.  Mobile PC users need to save
battery power via Black background.  White background causes snow
blindness.  Yellow and Black produce the highest contrast.  So Yellow URL's
might be a good choice, plus they look like sticky notes of interest which
is what they are really.

I'm not sure that we can go for black/white in the default, but we should certainly fix the color schema so it's more accessible.

An alternative might be the ability to select a "night mode" theme dropdown that has higher contrast.

https://illumos.github.io/docs/about/leadership/

Not sure "leadership" is the right phrasing. Dev Council needs to be defined first. Other flow/cleanup.

Expand. What exactly do these mean to us?

https://illumos.github.io/docs/about/#community-values

We need some updates for when the primary compiler is GCC7.