← Back to team overview

ubuntu-manual team mailing list archive

Re: Ubuntu Manual concerns

 

Hi Phil, I'm on holiday at the moment and will answer your email in more
detail next week. Regarding the attributions, we are going to do the credits
properly in a couple of weeks. The ones there at the moment are just a
placeholder (some of the names are just made up even!)

Talk to you later,

Benjamin

On 3/04/2010 4:02 AM, "Shaun McCance" <shaunm@xxxxxxxxx> wrote:

On Fri, 2010-04-02 at 15:44 +0100, Phil Bull wrote:
> The second is: Did you really have to fork so ...
In a linear book, you usually don't want to put main content behind
links to other resources. It works really nicely for help, but not
so well for books.

There is the question of how much of that content is actually useful
to the target reader in something with "Getting Started" in the title.
Encrypting files and folders doesn't strike me as a "Getting Started"
topic, for example.

When there is genuinely useful content that could be shared between
this manual and the system docs, I wonder if this could have been
handled better by using a format that is designed to handle content
reuse with build-time conditional processing. This is going to sound
strange coming from me, but here it is: DITA.

There are lots of technical solutions for content reuse. I think in
this case, though, the problem isn't technical. It's social.

--
Shaun




-- 
ubuntu-doc mailing list
ubuntu-doc@xxxxxxxxxxxxxxxx
https://lists.ubuntu.com/mailman/listinfo...

References