Hello,
Sorry for jumping on a running train. I participate in the Telegram
group Attila mentioned in his first message below. I too think it
would be awesome to get future and current openSUSE's users the best
doc available. However before anything else perhaps we should clarify
something. As I understand it, Attila's main point in his original
message was to lower the entry-barrier for new openSUSE users, not to
necessarily have the wiki removed and the doc rewritten.
If this is correct, then I think I share his goal, as I think the
easily accessible yet outdated wiki might intercept or delay users who
actually need to get the docs, while not necessarily creating a very
enticing experience. Of course every open source project needs active
volunteers, and a wiki makes this clear, But I think that the best way
to motivate new users is to first offer them information that is
relevant to their issues (and we know what issues new users are most
likely to run into), and to present it in an enjoyable way. Which
leads me to believe that:
1) a first layer of information catering to new users, anticipating
their needs and guiding them to better understand their issues, is
very valuable
2) the previous condition cannot be met only with static doc (i.e. a
manual or handbook in the sense of docs.opensuse.org), because a
manual is not enticing to everybody and does not unwrap information in
layers relevantly connected to common issues (being linear and not
interactive)
3) the current doc is awesome and I think it can stay the way it is
because it still performs an important role (i.e. a basic "source of
truth" for users who most need it)
Do we all agree on this? If so, and if I am understanding Attila's
initiative correctly, we'll need more than punctual, spontaneous
amendments to the docs. We need to discuss and coordinate to get
contents presented in a more perspicuous way. We need a "contents
redesign"..
What do you think?
Best,
Adrien
------------------------------------
Hi Lana,
Thank you for your help, much appreciated.
The repo you linked to seem to create content for doc.opensuse.org instead of
the openSUSE wiki (https://en.opensuse.org/Main_Page) or the wiki is being
phased out and things are being moved over to doc.opensuse.org?
To be honest I much prefer the format of doc.opensuse.org. Removing the wiki
might be a good idea or forwarding it to the docs.
Definitely missing content, the opening page would require some tuning and an
easier way to find it maybe?
Hopefully can assist with the work in the very near future after got the
technicalities out of the way.
Chances are that I'm going to take you up on your offer and disturb you with my
questions ;)
Attila
‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On Wednesday, September 9, 2020 7:40 AM, Lana Brindley