Bug 241814

Summary: Style revisions, accessibility enhancements, and ports statistics updates to "A project model for the FreeBSD Project"
Product: Documentation Reporter: Pau Amma <pauamma>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Some People CC: bcr, carlavilla
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://reviews.freebsd.org/D24321
Attachments:
Description Flags
Style revisions, accessibility enhancements, and ports statistics updates throughout the book.
none
share/images/books/dev-model/portsstatus.png none

Description Pau Amma 2019-11-08 23:21:45 UTC 
Created attachment 208988 [details]
Style revisions, accessibility enhancements, and ports statistics updates throughout the book.

Style revisions, accessibility enhancements, and ports statistics updates throughout the book.

- Make pronouns truly gender-agnostic.

- Correct typos and minor grammar errors.

- Update number of ports vs. time graph to a less outdated version (from https://web.archive.org/web/20121223081637if_/http://www.freebsd.org/ports/growth/status.png).

- Enhance screenreader friendliness of pictures.

- Remove reference to deleted image.

- Add link to FDP primer.

Tested with lynx, but should ideally be tested by someone using a screenreader.

Note 1: Images removed from the English version but still used by translations have been kept until the translations catch up. These images are: share/images/books/dev-model/hats-overview.png, share/images/books/dev-model/maintenance.png, share/images/books/dev-model/orghierarchy.png, share/images/books/dev-model/orghierarchy.sla, share/images/books/dev-model/orghierarchy2.png, and share/images/books/dev-model/proc-releng.png.

Note 2: I think it's OK to include a local copy of https://web.archive.org/web/20121223081637if_/http://www.freebsd.org/ports/growth/status.png in the document, since that image came from the FreeBSD website originally. But IANAL, so take that opinion with appropriate amounts of salt.

Note 3: I'm attaching the modified picture (share/images/books/dev-model/portsstatus.png) separately, because it doesn't look like uploading a svn diff will do the right thing with it.
Comment 1 Pau Amma 2019-11-08 23:23:38 UTC 
Created attachment 208989 [details]
share/images/books/dev-model/portsstatus.png
Comment 2 commit-hook freebsd_committer freebsd_triage 2020-05-01 10:15:57 UTC 
A commit references this bug:

Author: bcr
Date: Fri May  1 10:15:03 UTC 2020
New revision: 54087
URL: https://svnweb.freebsd.org/changeset/doc/54087

Log:
  A number of (much needed) updates and corrections to the
  dev-model book:
  - Make pronouns truly gender-agnostic
  - Correct typos and minor grammar errors
  - Update number of ports vs. time graph to a less outdated version
  (from [1])
  - Enhance screenreader friendliness of pictures
  - Remove reference to deleted image
  - Add link to FDP primer

  Thanks to Pau Amma for working on a patch and submitting it
  to us.

  [1] https://web.archive.org/web/20121223081637if_/http://www.freebsd.org/ports/growth/status.png

  PR:		241814
  Submitted by:	pauamma_gundo.com
  Reviewed by:	debdrub, bcr, allanjude
  Approved by:	bcr
  Differential Revision:	https://reviews.freebsd.org/D24321

Changes:
  head/en_US.ISO8859-1/books/dev-model/Makefile
  head/en_US.ISO8859-1/books/dev-model/book.xml
Comment 3 Benedict Reuschling freebsd_committer freebsd_triage 2020-05-01 10:16:39 UTC 
Thank you for working with us on fixing this issue you've reported. PR closed!