Handbook Jail Chapter rewrite available for critique

[Fbsd8]

To all interested parties;

I have completed the final draft of the total rewrite of FreeBSD's 
handbook Chapter 16 on Jails.


Before submitting my work for submission to the documentation group for 
insertion in the handbook I am looking for critique of the work to find 
errors in concept, wrong use of words, or anything to make it better.


All feedback welcomed.

Use this URL to access it  http://www.jails.a1poweruser.com/


Thank You.

___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Handbook Jail Chapter rewrite available for critique

[Fbsd8]

To all interested parties;

I have completed the final draft of the total rewrite of FreeBSD's
handbook Chapter 16 on Jails.

Before submitting my work for submission to the documentation group for
insertion in the handbook I am looking for critique of the work to find
errors in concept, wrong use of words, or anything to make it better.

All feedback welcomed. Please email me directly so we keep the noise 
down on the mailing list.


Use this URL to access it  http://www.jails.a1poweruser.com/


Thank You.




___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/179443: Rewrite of the Handbook Chapter 16 Jails.

[Fbsd8]

g...@freebsd.org wrote:

Synopsis: Rewrite of the Handbook Chapter 16 Jails.

State-Changed-From-To: open->suspended
State-Changed-By: gjb
State-Changed-When: Sun Jun 9 18:16:21 UTC 2013
State-Changed-Why: 
The provided URL does not exist.


gjb@nucleus:~ % fetch -o /dev/null 
http://downloads.sourceforge.net/projects/qjail/handbook/index.html
fetch: http://downloads.sourceforge.net/projects/qjail/handbook/index.html: Not 
Found


http://www.freebsd.org/cgi/query-pr.cgi?pr=179443




The PR says to use FTP. Why are you trying to use fetch?
Please follow the instructions as written.
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/179443: Rewrite of the Handbook Chapter 16 Jails.

[Fbsd8]

g...@freebsd.org wrote:

Synopsis: Rewrite of the Handbook Chapter 16 Jails.

State-Changed-From-To: suspended->closed
State-Changed-By: gjb
State-Changed-When: Sun Jun 9 21:12:15 UTC 2013
State-Changed-Why: 
URL is not found with ftp(1) either.


  gjb@nucleus:~/freebsd/relengsvn/src % ftp -o /dev/null \
http://downloads.sourceforge.net/projects/qjail/handbook/index.html
  Requesting http://downloads.sourceforge.net/projects/qjail/handbook/index.html
  ftp: Error retrieving file `404 Not Found'

Perhaps you do not realize that the utility used to obtain the file does not
matter when the file does not exist.

That said, the PR also says "Do whatever you want with it."

So, PR closed.  If you would like to show some respect to those who were
entertaining the thought of looking at your document, maybe it will be
reopened.  But not by me.


http://www.freebsd.org/cgi/query-pr.cgi?pr=179443




Sorry typo in url

it's project not projects

ftp http://downloads.sourceforge.net/project/qjail/handbook/index.html


___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/179443: Rewrite of the Handbook Chapter 16 Jails.

[Fbsd8]

re...@freebsd.org wrote:

Synopsis: Rewrite of the Handbook Chapter 16 Jails.

State-Changed-From-To: open->feedback
State-Changed-By: remko
State-Changed-When: Sat Jun 15 19:48:54 UTC 2013
State-Changed-Why: 
Dear Joe,


Please submit an unified diff so that I can review what you have written and 
what
the changes are. I will not be looking at the raw HTML you provided. In addition
it seems that from a peek only you are the contributor, but we both know that 
that is
not the case.

I still have the qjail vs ezjail discussion in mind, so I think you should 
provide
a very  heldback diff and not change the contributors at all (which you seem to 
be
doing again).



Responsible-Changed-From-To: freebsd-doc->remko
Responsible-Changed-By: remko
Responsible-Changed-When: Sat Jun 15 19:48:54 UTC 2013
Responsible-Changed-Why: 
Take the PR so that I can either close it or work on it IF joe convinces

me that it's worth the trouble.

http://www.freebsd.org/cgi/query-pr.cgi?pr=179443





Hello Remko:

You are way off base here. Your judgment is clouded by things that have 
no bearing on this PR.


The handbook jail chapter rewrite has nothing to do with ezjail or qjail 
ports. If you would have taken the time to study the html doc you would 
have seen that for your self. Just because qjail was created by 
Filipinos who are not knowledgeable in open source protocol is no reason 
to insinuate things were done on purpose with intent. We now know we 
erred in judgment and have resolved the problem. So lets put this behind 
us and move on with this PR.


The word "rewite" in the PR subject means this html content is intended 
to replace the existing content of the current handbook chapter 16. The 
PR "subject" sure seem very clear in that meaning.


If the Doc group members feels that they want to keep the current 
outdated handbook chapter 16 content, and add what I wrote as another 
sub-section, thats for the Doc team members to discuss and decide as a 
group.


From the tone of what you wrote I don't feel you can be fair and 
professional in your judgment concerning this PR. If you can convince me 
that you can put the past behind you and change your attitude them you 
can work this PR, otherwise just return it to open status for some other 
Doc member to select to take it on.





___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

doc committors abusing powers for personal agenda.

[Fbsd8]

I want to report 2 doc team members who are abusing their commit 
privileges. The attitude they have shown me is the complete opposite 
from what I experienced at the BSDcan "doc lounge".


I am trying to reach the person in control of the doc team. Someone who 
has the overall authority to review their PR postings and revoke their 
commit powers.


If you are this person then please reply in a timely manner 
demonstrating your interest to investigate my allegations.


Sincerely yours
Joe Barbish
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/144515: [handbook] Expand handbook Table of contents

[Fbsd8]

ga...@freebsd.org wrote:

Synopsis: [handbook] Expand handbook Table of contents

State-Changed-From-To: open->closed
State-Changed-By: gabor
State-Changed-When: Wed Jan 22 14:37:11 UTC 2014
State-Changed-Why: 
Currently, the TOC has three levels: part, chapter and section.  I am afraid

that expanding more levels would be to verbose and thus affect usability.
It is possible to download full PDF or HTML where you can use the search
functions. Alternatively, you can use the index, however it needs some
impriovements.


Responsible-Changed-From-To: freebsd-doc->gabor
Responsible-Changed-By: gabor
Responsible-Changed-When: Wed Jan 22 14:37:11 UTC 2014
Responsible-Changed-Why: 
Currently, the TOC has three levels: part, chapter and section.  I am afraid

that expanding more levels would be to verbose and thus affect usability.
It is possible to download full PDF or HTML where you can use the search
functions. Alternatively, you can use the index, however it needs some
impriovements.

http://www.freebsd.org/cgi/query-pr.cgi?pr=144515



I don't think you read or understood the pr. All the sub-sections are 
not findable, meaning there hidden. Expanding the TOC just one more 
level to include the sub-sections is required to make the complete 
contents accessible from the TOC just like any other professionally 
published book.


I though the goal of the handbook was to be usable and here we have our 
main documentation looking like something created by people who don't 
even know the normal standard parts of a published document or the 
professional way to organize content.


Closing this pr with the suggestion that users should use some other 
method to search the handbook is just ludicrous and sounds like it's 
nothing but a effort to shorten the open doc pr list with the least 
amount of work.


What every happened to one's pride in one's workmanship?
After the FreeBSD website isn't the handbook the second most accessed 
element of the FreeBSD world seen by the public? The image and 
reputation of FreeBSD are at stake here. This pr is very important in 
modernizing the handbook and should have bee opened up for discussion 
among all the doc members and only closed by agreement of the doc team 
and not out of hand by someone who in my opinion is misusing their 
commit privileges in this case.



___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/144515: [handbook] Expand handbook Table of contents

[Fbsd8]

Glen Barber wrote:

On Thu, Jan 23, 2014 at 09:52:55AM +0800, Fbsd8 wrote:

I though the goal of the handbook was to be usable and here we have our main
documentation looking like something created by people who don't even know
the normal standard parts of a published document or the professional way to
organize content.



Your insults are not appreciated.

Please reconsider your response, and if you feel there is still
a concern, reply in a professional, non-insulting manner.

Glen



Well Glen what you consider insulting I consider frank and to the point. 
 Since when do people have to accept your censorship? There is no 
censorship on any of the FreeBSD lists so quite trying to force your 
personal old fashioned thin skinned attitudes on the members of this 
list. I find your remarks to be insulting and totally out of place. And 
as usual you remove from the post the text that explains that statement 
so you can take it out of context. shame on you, you should know better, 
you have been called on this before. Any future reply to this thread by 
you will go unanswered by me for I will not lower myself to your level.


___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: docs/144515: [handbook] Expand handbook Table of contents

[Fbsd8]

Thomas Hoffmann wrote:
On Thu, Jan 23, 2014 at 11:18 AM, Gabor Kovesdan > wrote:


On 2014.01.23. 16 :59, Thomas Hoffmann wrote:

I agree, the TOC is already too long vertically. Adding
subsections would exacerbate the problem.

By "horizontal page" I mean taking advantage of the full screen
width, for example, by using multi-columns or similar technique.
That would get more info on each screen page. Compare the TOC
with the x-config.html page (

http://www.freebsd.org/doc/en___US.ISO8859-1/books/handbook/x-__config.html

),
which uses the full page width.

The problem with this is that TOC is a multiple level enumeration by
nature, which is conventionally listed vertically in order. Using
two columns may be confusing for people since it is not
conventional. And if we use 2 columns, what order would it follow?
Like this:

12
1.12.1
1.22.2
1.32.3

Or this:

1
1.11.2
1.31.4

And what to do on smaller screens if the two columns do not fit?

I believe that a collapsible tree list would be the best option but
that requires JavaScript, which we prefer to avoid...

Gabor


Top to bottom, left to right would be the normal "western" approach, no?

Personally, I would have no problem with a TOC that only listed the 
major chapters. If you want the details sections/subsections) you would 
drill (click) down as required:

1.6.
2.7.
3 8.
4.9.
5.   10.

or even

1.
2.
3.
4.
5.
6.
etc.

It would require less scrolling, but this might be objectionable to many.

I understand completely your desire to avoid JS.

This may simply be an intractable problem.

-Tom



Since the handbook is published using a new tool set, just how does this 
new tool set auto build the TOC?


If I remember correctly there was some posts a while back about forcing 
the publish tool to not build a complete TOC, ie: dropping the 
subsections. Maybe the simple solution is to allow the new tool set to 
build a complete TOC automatically.


___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: ezjail Handbook section

[Fbsd8]

Warren Block wrote:

Draft version of an ezjail section for the Handbook Jails chapter:
http://www.wonkity.com/~wblock/jails/jails-ezjail.html

This includes a complete setup at the end for running BIND in a jail.
In addition to a complete jail example, it can also serve as an example 
of how to set up BIND now that the old chroot configuration is no more.




The Freebsd handbook is not the correct place to document a port 
utility. Are you also going to include the other ports that are jail 
utilities?


___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Re: Handbook Section 15.5.1 & 2 rewritten.

[Fbsd8]

Ben H. via freebsd-doc wrote:

DaemonForums - View Single Post - Help getting Jail started...

  
  
DaemonForums - View Single Post - Help getting Jail started...
BSD discussion forums  
View on daemonforums.org Preview by Yahoo  
  
  


1. My jail failed to start following the current instructions in these sections.
2. Current instructions do not incorporate ZFS datasets.
3. Current instructions do not incorporate /etc/jail.conf configuration.

 
BForest strbenjr{a}yahoo.com


Here is a Handbook Jail chapter rewrite that was rejected last year. 
Maybe its now time to consider it again.


It was converted into a port named jail-primer 
http://jail-primer.sourceforge.net/





___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"