headers
Julian Fagir | 14 Aug 2011 23:55
Picon

Guide: Switching from Linux to NetBSD

Hi,

we've tried to write a guide about switching from GNU/Linux to NetBSD.
I would be thankful for anybody reviewing and eventually committing it:
http://komkon2.de/switchinglinux.xml (main article)

If somebody would be willing to commit it, these two changes should be the
ones to put it into the website: http://komkon2.de/docs-index.xml.diff
http://komkon2.de/docs-Makefile.diff
Feel free to change it to any other format if you think it does not fit on
the website.

Regards, Julian
Permalink | Reply | 8 comments |
headers
Mark Weinem | 16 Aug 2011 02:04
Picon
Favicon

Re: Guide: Switching from Linux to NetBSD

Hi Julian,

you wrote:
> we've tried to write a guide about switching from GNU/Linux to NetBSD.
> I would be thankful for anybody reviewing and eventually committing it:
> http://komkon2.de/switchinglinux.xml (main article)

Reviewers can find the html page at:

http://www.NetBSD.org/~weinem/switchinglinux.html

It's a  good start but needs more focussed content, more links and some 
xml fixing.

It does not yet describe how to *switch* from Linux to NetBSD.

It contains duplicate content which is already available elsewhere: 
"Documentation", "Commmunity/bugreports"

And some content is missing.

> If somebody would be willing to commit it, these two changes should be the
> ones to put it into the website: http://komkon2.de/docs-index.xml.diff
> http://komkon2.de/docs-Makefile.diff

The diff for htdocs/layout.xml is missing.

Best regards, Mark Weinem
(Continue reading)

Permalink | Reply | 7 comments |
headers
Julian Fagir | 16 Aug 2011 03:20
Picon

Re: Guide: Switching from Linux to NetBSD

Hi,

> > we've tried to write a guide about switching from GNU/Linux to NetBSD.
> > I would be thankful for anybody reviewing and eventually committing it:
> > http://komkon2.de/switchinglinux.xml (main article)
> 
> Reviewers can find the html page at:
> 
> http://www.NetBSD.org/~weinem/switchinglinux.html
thank you! I can't build the html site myself as I don't have the tools
installed (and not enough disk space and performance to do so in time).

> It's a  good start but needs more focussed content, more links and some 
> xml fixing.
>
> It does not yet describe how to *switch* from Linux to NetBSD.
> 
> It contains duplicate content which is already available elsewhere: 
> "Documentation", "Commmunity/bugreports"
> 
> And some content is missing.
I think the links, XML and content issues are all the same. Some of them are
fixed. Some manpage-links are missing because they are not in 5.1, but in
current. I will fix that when I have an overview of what is missing.

The content is meant to be redundant. Sure all the information can be found
elsewhere, most of the article is just about wrapping some text around
manpage links. But that was my intention: Provide a central point where you
can read once about differences - and not stand in front of a completely new
operating system picking up information, digging through manpages about every
(Continue reading)

Permalink | Reply | 6 comments |
headers
Mark Weinem | 17 Aug 2011 00:51
Picon
Favicon

Re: Guide: Switching from Linux to NetBSD

Hi Julian,

> The content is meant to be redundant.

This is another highway to "Unmaintainable Documentation Hell" ;-)

"Don't Repeat Youreslf", "Duplicate Is Evil" or "Single Source Of Truth" 
will help us to keep the documentation maintainable.

> But that was my intention: Provide a central point where you
> can read once [...]

That's the purpose of the Guide. It doesn't deal with specific 
differences so it's useful for any OS-convert.

> So, it does not describe any technical details about how to really switch
> (installing NetBSD or migrating services), that's out of the scope of the
> article.

Why not? That would be a concrete benefit!

> the reader of this article should be capable of switching or creating a plan
> on how to switch after reading it.

Should be possible after studying the Guide - independent from reader's 
OS-background.

> I have fixed some issues, you can look up the updated article at
> http://komkon2.de/switchinglinux.xml.
(Continue reading)

Permalink | Reply | 5 comments |
headers
Julian Fagir | 17 Aug 2011 13:40
Picon

Re: Guide: Switching from Linux to NetBSD

Hi,

> > The content is meant to be redundant.
> 
> This is another highway to "Unmaintainable Documentation Hell" ;-)
> 
> "Don't Repeat Youreslf", "Duplicate Is Evil" or "Single Source Of Truth" 
> will help us to keep the documentation maintainable.
> 
> 
> > But that was my intention: Provide a central point where you
> > can read once [...]
> 
> That's the purpose of the Guide. It doesn't deal with specific 
> differences so it's useful for any OS-convert.
imho, the guide reteaches much you already know by using Linux, and it's hard
to extract the information really important for a Linux-comer.
But you're right, the guide does not really fit onto the website. I have
written it in Markdown in the beginning but then I thought that the wiki is
still not usable for such things, so I spent hours converting it to
Docbook... ;)

> > So, it does not describe any technical details about how to really switch
> > (installing NetBSD or migrating services), that's out of the scope of the
> > article.
> 
> Why not? That would be a concrete benefit!
I think that is not possible due to the variety of different Linux flavours
and tools. You could not even write something on how to convert init scripts,
as they're different from SysV to upstart to systemd.
(Continue reading)

Permalink | Reply | 4 comments |
headers
Mark Weinem | 17 Aug 2011 17:07
Picon
Favicon

Re: Guide: Switching from Linux to NetBSD

On 08/17/11 13:40, Julian Fagir wrote:

>> http://www.NetBSD.org/~weinem/switchinglinux.html
> Thank you for your error output. It is mostly due to category-changes from
> 5.1 to current. I don't understand why he does not get the pkg_*.1-manpages,
> they're all in that category.

Just have a look at htdocs/share/xml/man-refs.ent - you cannot use 
underscores.

> As I said, unfortunately I don't have the space to convert the texts myself,
> then I would handle that all on my own.

We will run the builds for you, that's no problem. It's not mandatory to 
have all the stuff installed. Just provide the xml files or the diffs.

Many thanks & best regards, Mark
Permalink | Reply | 3 comments |
headers
Brian Seklecki (Mobile | 17 Aug 2011 17:15

Re: Guide: Switching from Linux to NetBSD

On Wed, 17 Aug 2011, Mark Weinem wrote:

> On 08/17/11 13:40, Julian Fagir wrote:
>
>
>>> http://www.NetBSD.org/~weinem/switchinglinux.html
>> Thank you for your error output. It is mostly due to category-changes from

   I think its a good start; I'll send you some notes

  ~BAS (A *BSD guy working for a redhat/aix/hpux Shop)
Permalink | Reply | 0 comments |
headers
Julian Fagir | 17 Aug 2011 20:23
Picon

Re: Guide: Switching from Linux to NetBSD

Hi,

> >> http://www.NetBSD.org/~weinem/switchinglinux.html
> > Thank you for your error output. It is mostly due to category-changes from
> > 5.1 to current. I don't understand why he does not get the
> > pkg_*.1-manpages, they're all in that category.
> 
> Just have a look at htdocs/share/xml/man-refs.ent - you cannot use 
> underscores.
ok, thank you. That was fixed, as were the other manpage links.

The last problem seems to be a greater story: How do I make paragraphs in a
sect2 visible? I just don't get it, maybe there's another person with some
docbook-knowledge out there who can help.
This is not only my issue, but e.g. bootcd.xml also has a paragraph 704-708l
that is not shown in the end: http://www.netbsd.org/docs/bootcd.html, but
index.xml got it: http://www.netbsd.org/docs/ (195-204l).

If you could give me just a small hint... I'm just kind of clueless about
Docbook.

Regards, Julian
Permalink | Reply | 1 comment |
headers
Mark Weinem | 18 Aug 2011 00:54
Picon
Favicon

Re: Guide: Switching from Linux to NetBSD

On 08/17/11 20:23, Julian Fagir wrote:

> How do I make paragraphs in a sect2 visible?
> I just don't get it, maybe there's another person with some
> docbook-knowledge out there who can help.
> This is not only my issue, but e.g. bootcd.xml also has a paragraph 704-708l
> that is not shown in the end: http://www.netbsd.org/docs/bootcd.html, but
> index.xml got it: http://www.netbsd.org/docs/ (195-204l).

I think that's not possible within "role=toc", but I might be wrong. I 
have always worked around this.

docs/index.xml doesn't use "role=toc"

Best regards, Mark
Permalink | Reply | 0 comments |

Gmane