Bug 241814 - Style revisions, accessibility enhancements, and ports statistics updates to "A project model for the FreeBSD Project"
Summary: Style revisions, accessibility enhancements, and ports statistics updates to ...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL: https://reviews.freebsd.org/D24321
Keywords: patch
Depends on:
Blocks:
 
Reported: 2019-11-08 23:21 UTC by Pau Amma
Modified: 2020-05-01 10:16 UTC (History)
2 users (show)

See Also:


Attachments
Style revisions, accessibility enhancements, and ports statistics updates throughout the book. (55.63 KB, patch)
2019-11-08 23:21 UTC, Pau Amma
no flags Details | Diff
share/images/books/dev-model/portsstatus.png (4.55 KB, image/png)
2019-11-08 23:23 UTC, Pau Amma
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
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!