Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-04 Thread Karl O. Pinc
On 01/03/2011 02:31:51 PM, Christian PERRIER wrote:

 Squeeze is about to be released, in a few weeks at best (or
 worse). So, I don't really see by which magic this would happen
 (considering that any change now to the installation guide triggers a
 need for translation updates).

I do not wish to advise you as to how to run your project
but it occurs to me that, because this patch has nothing
to do with the code of the installer or it's operation, that 
the web pages of the translations _could_ be updated,
even after release, as the translations arrive.
Nothing would be lost to those without a translation
and something gained by the rest.

(No need to reply to this message unless you feel
like educating me as to your policies or process.)

Regards,

Karl k...@meme.com
Free Software:  You don't pay back, you pay forward.
 -- Robert A. Heinlein




--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-03 Thread Karl O. Pinc
Package: installation-guide
Severity: wishlist

Hi,

Many users expect that their system have software that's
not in the stock Debian stable repos.  Examples include newer
versions of major desktop packages found in backports,
various programs supporting different sorts of multi-media
display, and so forth.  Chapter 8, next steps,
should either include the content of or point users
toward a resource like
http://wiki.debian.org/DebianSoftware, which describes
other software resources that are supported by the Debian
community at large.

This should help attract and retain users who think that
Debian does not run the software they want.  I am not
proposing to ignore the Debian Social Contract
in an effort to attract as many users as possible.
I am proposing that Debian advertise it's capabilities 
to compete with other distros for users.  Referring
new users to community supported software resources
would enhance the Debian experience and further this goal.

(Ideally this change would be made before the squeeze
release so as not to lose years of new users.)

Regards,

Karl O. Pinc

-- System Information:
Debian Release: 5.0.7
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.26-2-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-03 Thread Christian PERRIER
Quoting Karl O. Pinc (k...@meme.com):

 Many users expect that their system have software that's
 not in the stock Debian stable repos.  Examples include newer
 versions of major desktop packages found in backports,
 various programs supporting different sorts of multi-media
 display, and so forth.  Chapter 8, next steps,
 should either include the content of or point users
 toward a resource like
 http://wiki.debian.org/DebianSoftware, which describes
 other software resources that are supported by the Debian
 community at large.
 
 This should help attract and retain users who think that
 Debian does not run the software they want.  I am not
 proposing to ignore the Debian Social Contract
 in an effort to attract as many users as possible.
 I am proposing that Debian advertise it's capabilities 
 to compete with other distros for users.  Referring
 new users to community supported software resources
 would enhance the Debian experience and further this goal.
 
 (Ideally this change would be made before the squeeze
 release so as not to lose years of new users.)

Squeeze is about to be released, in a few weeks at best (or
worse). So, I don't really see by which magic this would happen
(considering that any change now to the installation guide triggers a
need for translation updates).

I for one am all in favor of increasing the user accessibility to
Debian, but I really can't see how what you suggest will be
done...particularly if no patch is proposed..:-)

So, indeed, thanks in advance for the upcoming patch you will propose.




signature.asc
Description: Digital signature


Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-03 Thread Karl O. Pinc
On 01/03/2011 02:31:51 PM, Christian PERRIER wrote:
 Quoting Karl O. Pinc (k...@meme.com):
 
  Many users expect that their system have software that's
  not in the stock Debian stable repos. 

  Chapter 8, next steps,
  should either include the content of or point users
  toward a resource like
  http://wiki.debian.org/DebianSoftware, which describes
  other software resources that are supported by the Debian
  community at large.

  (Ideally this change would be made before the squeeze
  release so as not to lose years of new users.)
 
 Squeeze is about to be released, in a few weeks at best (or
 worse). So, I don't really see by which magic this would happen
 (considering that any change now to the installation guide triggers a
 need for translation updates).
 
 I for one am all in favor of increasing the user accessibility to
 Debian, but I really can't see how what you suggest will be
 done...particularly if no patch is proposed..:-)
 
 So, indeed, thanks in advance for the upcoming patch you will 
 propose.

My inclination is to add minimal text which contains a link
to http://wiki.debian.org/DebianSoftware.  (Which has only
an Italian translation at the moment.)

Something like:
Chapter 8. Next Steps and Where to Go From Here
...
8.3. Orienting Yourself to Debian
...
8.3.1. Debian Packaging System
... (all existing content)
---snip--

8.3.1.1 Additional Software Available for Debian

There are official and unofficial software repositories that
are not enabled in the default Debian install.  These
contain software which many find important and
expect to have.  Information on these additional 
repositories can be found on the Debian Wiki page
The Software Available for Debian's Stable Release
(http://wiki.debian.org/DebianSoftware).

---snip--

I would be happy to submit a source patch in
appropriate markup if this sounds desirable.

The advantage of referencing the wiki is that it keeps
things short and allows for dynamic changes (such
as the incorporation of backports into Debian
proper, if that can be considered dynamic.)

Of course there are also advantages to incorporating
content directly into the install guide.  If that
is desired I'd be happy to attempt to re-tool the
wiki page.

Karl k...@meme.com
Free Software:  You don't pay back, you pay forward.
 -- Robert A. Heinlein




--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-03 Thread Karl O. Pinc
On 01/03/2011 04:27:46 PM, Karl O. Pinc wrote:
 On 01/03/2011 02:31:51 PM, Christian PERRIER wrote:
  Quoting Karl O. Pinc (k...@meme.com):
  
   Many users expect that their system have software that's
   not in the stock Debian stable repos.

  
  So, indeed, thanks in advance for the upcoming patch you will 
  propose.
 
 My inclination is to add minimal text which contains a link
 to http://wiki.debian.org/DebianSoftware.  (Which has only
 an Italian translation at the moment.)
 
 Something like:
 Chapter 8. Next Steps and Where to Go From Here
 ...
 8.3. Orienting Yourself to Debian
 ...
 8.3.1. Debian Packaging System
 ... (all existing content)
 ---snip--
 
 8.3.1.1 Additional Software Available for Debian

Would it be better to keep it only 3 levels of section
deep so that it shows up in the table of contents?
(Make it 8.3.2?)



Karl k...@meme.com
Free Software:  You don't pay back, you pay forward.
 -- Robert A. Heinlein




--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#608828: installation-guide: Users need direction to the functionality they expect

2011-01-03 Thread Karl O. Pinc
On 01/03/2011 04:43:43 PM, Karl O. Pinc wrote:
 On 01/03/2011 04:27:46 PM, Karl O. Pinc wrote:
  On 01/03/2011 02:31:51 PM, Christian PERRIER wrote:
   Quoting Karl O. Pinc (k...@meme.com):
   
Many users expect that their system have software that's
not in the stock Debian stable repos.
 
   
   So, indeed, thanks in advance for the upcoming patch you will 
   propose.
  
  My inclination is to add minimal text which contains a link
  to http://wiki.debian.org/DebianSoftware.  (Which has only
  an Italian translation at the moment.)
  
  Something like:
  Chapter 8. Next Steps and Where to Go From Here
  ...
  8.3. Orienting Yourself to Debian
  ...
  8.3.1. Debian Packaging System
  ... (all existing content)
  ---snip--
  
  8.3.1.1 Additional Software Available for Debian
 
 Would it be better to keep it only 3 levels of section
 deep so that it shows up in the table of contents?
 (Make it 8.3.2?)

Attached is a patch (with a new section at level 3 (8.3.2)).

cd trunk/manual/en/post-install; patch  orientation.xml.repos.patch

Please let me know if you think another approach would be better.

Regards,

Karl k...@meme.com
Free Software:  You don't pay back, you pay forward.
 -- Robert A. Heinlein

Title: Additional Software Available for 
--- orientation.xml	2011-01-03 20:13:53.0 -0600
+++ orientation.xml.new	2011-01-03 20:25:41.0 -0600
@@ -67,6 +67,19 @@
 
   
 
+  
+
+
+There are official and unofficial software repositories that are not
+enabled in the default  install.  These contain software which
+many find important and expect to have.  Information on these
+additional repositories can be found on the  Wiki page titled
+The Software
+Available for 's Stable Release.
+
+
+  
+
   Application Version Management