[Bug 273244] FDP: make the FreeBSD Documentation Project Primer realistic, with regard to contributions

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=273244

            Bug ID: 273244
           Summary: FDP: make the FreeBSD Documentation Project Primer
                    realistic, with regard to contributions
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/commit/c4ab1268
                    05b0ecf8d200daba8990ddaac649b18f#diff-d1c4411873fcc149
                    d78fd656312ffd32333c80fbfc328cc1909adfc0217a686fR101
                OS: Any
            Status: New
          Keywords: easy, needs-patch
          Severity: Affects Many People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com

Created attachment 244225
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=244225&action=edit
notification buttons – None | All | Status

> Edit this page

- appears in documentation at docs.freebsd.org – for example, 
  <https://docs.freebsd.org/en/books/fdp-primer/overview/>

> … we value your contributions very highly. …

The resulting workflow (three buttons, a norm for users of GitHub): 

1. Commit changes…

2. Propose changes

3. Create pull request

Where people oversubscribe – and then, are either unaware (or wilfully
ignorant) of None and Status buttons: 

- contributions may be perceptibly less than valuable. 

Please fix the primer. 

At least: be honest about what contributors should expect.

Thanks

----

In the meantime, there remain seven PRs at
<https://github.com/freebsd/freebsd-doc/pulls>: 

- some of which might please subscribers, in the context of  
 
<https://docs.freebsd.org/en/books/fdp-primer/book/#weblate-become-translator> 
  point 6

    "… The Documentation project is also accepting GitHub 
     Pull Requests with translation submissions."

- others might cause displeasure, and be subject to moves 
  away from the FreeBSD repo, to forks.

-- 
You are receiving this mail because:
You are the assignee for the bug.