:: Re: [DNG] What should an Install Gu…
Góra strony
Delete this message
Reply to this message
Autor: Ralph Ronnquist
Data:  
Dla: dng@lists.dyne.org
Temat: Re: [DNG] What should an Install Guide accomplish?
Concise is perfect, if comprehensive, within reason. And, perhaps gilded
by a (growing?) collection of links to "user stories"?

Ralph.

chillfan--- via Dng wrote on 02/01/19 16:53:
> Historically the community has always responded to things that are minimal and simple, and not so much to things that are bloated or windowsy, or similar. Imho, a reason why a new user might look to Devuan could be because it's less like windows than some of the others, and the community supports the goal of simpler living with your OS.
>
> Actually, I think these problems should be solved just not directly in Devuan. If there comes a time when someone creates a spin specifically for new users, that would solve all those problems.
>
> Cheers,
>
> chillfan
>
> ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
> On Tuesday, January 1, 2019 11:34 PM, Michael <mb_devuan-mailinglist@???> wrote:
>
>> Hi golinux and everyone else,
>>
>
>> Okay, I’m breaking this topic off from the ‘Added desktop-live to the install
>> guides’ as it seems we have a much higher, philosophical level decision to
>> make before we can continue with editing the Devuan Install Guide. Which is:
>>
>
>> == What should an Install Guide accomplish?
>>
>
>> #
>>
>
>> ==
>>
>
>> My take is that an Install Guide is a complete set of instructions that a
>> person can follow to fully accomplish the task. There are no ambiguities
>> presented to the user, as it is literally do step a), do step b), do step
>> c) ...
>>
>
>> Each step should be fully explained and if there is more than one primary
>> method of doing any of the steps, then each method is explained. In this
>> case my take is that both Nix and Windows instructions should be available.
>>
>
>> # Minor points
>>
>
>> ===============
>>
>
>> = I am fully against against repeating any information on a website. As doing
>> so almost always leads to discrepancies between the difference sources. If
>> the Devuan site is using a CMS of some sort, then a single source should be
>> able to be created and block inclusions can be then placed anywhere else on
>> the site as needed. [1]
>>
>
>> = I do think that anything a user needs to know to make an intelligent
>> decision should be either on the page or directly linked to. If linked to,
>> then clicking the link should not close or overwrite the Install Guide page.
>>
>
>> = For an Install Guide I’m against ‘Minimalism.’ My feeling is that not
>> giving total, and literally an over abundance of information, not only
>> directly inhibits and stops people from doing the Install, but also creates
>> vast negative word of mouth from those who attempt the Install but can’t
>> complete it because they aren’t given enough information to physically be
>> able to follow it.
>>
>
>> = If golinux agrees to ‘an over abundance of information approach,’ I have no
>> issue re-writing the whole guide. (As you may have noticed I’m a bit gabby.)
>> I will need someone with a Windows box to QC those instructions.
>>
>
>> #
>>
>
>> ==
>>
>
>> Okay, that’s my fairly opinionated opinion. I think ultimately this is
>> golinux’s decision, but please everyone else jump in with yea’s, nay’s, and
>> what you think the answer to the question is ;) Also, please don’t feel shy
>> about bringing up what you think the ramifications might be for the different
>> options/opinions/methods. I bring this last point up, as I have a gut feel
>> that if we come to agreement on the ramifications, then we’ll have
>> our ‘decision’ per say made for us.
>>
>
>> Best Regards All and Happy New Year!,
>> Michael
>>
>
>> PS: golinux, my full apologies if I’ve stepped on your toes :( and/or
>> exceeded what you’re willing to take under discussion.
>>
>
>> [1] I host and manage Drupal (CMS) websites, this generally takes 10 minutes
>> to setup. I can discuss this offline with whoever as desired.
>>
>
>> Dng mailing list
>> Dng@???
>> https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dng
>
>
>
> _______________________________________________
> Dng mailing list
> Dng@???
> https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dng
>