Page MenuHomeFreeBSD

Add "education" virtual category to Porter's Handbook.
ClosedPublic

Authored by pauamma_gundo.com on Nov 23 2020, 2:23 PM.

Details

Summary

The category itself was added to the ports framework in r555738.

While there, fix a typo.

PR: 248403

Test Plan

Tested with lynx.

Checked that igor doesn't complain about this specific area.

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

ygy added a subscriber: ygy.

Looks good to me (doc), thanks for the work!

The "Any of:" part doesn't feel right to me, because it's restrictive. Can you maybe flip it around? "Applications, utilities, or games primarily[...] or study in general, such as: course-writing or course-delivery applications[...]". Something like that gives context and hints as to what belongs without restricting its ability to grow over time.

The "Any of:" part doesn't feel right to me, because it's restrictive. Can you maybe flip it around? "Applications, utilities, or games primarily[...] or study in general, such as: course-writing or course-delivery applications[...]". Something like that gives context and hints as to what belongs without restricting its ability to grow over time.

Hmm. You're right that "any of" feels restrictive, but "foo such as bar", to me, implies that bar is a subset of foo, which isn't the case here. How about just changing "Any of:" to "Such as:" before the inline list?

The "Any of:" part doesn't feel right to me, because it's restrictive. Can you maybe flip it around? "Applications, utilities, or games primarily[...] or study in general, such as: course-writing or course-delivery applications[...]". Something like that gives context and hints as to what belongs without restricting its ability to grow over time.

Well, the category is restrictive, so it feels like ok to me, but turning the sentence around, and maybe chopping it into smaller sentences would be nice, maybe:

Applications, utilities, or games primarily or substantially designed to help the user learn a specific topic or study in general. For example, course-writing or course-delivery applications, classroom or school management applications.

In D27340#611315, @mat wrote:

Applications, utilities, or games primarily or substantially designed to help the user learn a specific topic or study in general. For example, course-writing or course-delivery applications, classroom or school management applications.

"Any of" felt okay to me, but I like this one better since they are now complete and smaller sentences.

  • This should address all comments so far.
This revision is now accepted and ready to land.Dec 3 2020, 6:05 PM

Reminder if needed: I'm not a committer, so one will have to take care of this.

Thanks! I will commit it shortly.

This revision was automatically updated to reflect the committed changes.