Comments (4)
@crispy8888 Chris LP and I independently decided awhile back during one of the books that it should be UIThing
s, and that's what I've done since then. But it does always stick out in copy and bug me.
Here's what Apple says:
Code font in text
[...]
Donβt mix fonts within a single word. Rewrite to avoid forming the plural of a word in code font.
Correct: values of type integer
Incorrect: integer
s
Of course, Apple says to do many things that we don't do, like put variables in text in italics. But this advice does seem sound to me. Though, probably it's a rare reader who cares if UIThings
is technically incorrect.
Let's ask @gregheo, @wlinc and @rwenderlich what they think.
from english-style-guide.
I hate the look of UIThing
s. While it looks particularly horrible here on GitHub issues, it's not too bad on the site and books.
It's extra wordy, but I try to write "UIThing
objects" or "Int
values" or "NSWhatever
instances" as appropriate. I'm not always consistent at editing these out but I do it sometimes.
Some authors like to name types a lot, which means you run into this plural thing a lot:
In your
UIViewControllers
it's important to have references to otherUIViewControllers
to then draw to theirUIViews
inside all of theirframes
.
Personally, I think too many shifts to code style is distracting. A UITableView
is a "table view" and unless spelling out the exact class name is important, I'd rather write "table view".
In your
UIViewController
objects, it's important to have references to other view controllers to then draw to their views inside their frames.
from english-style-guide.
Agree with the sentiment that it looks odd, and I think it looks odd no matter the medium. Hence, I typically edit "pluralized" code out through strategic rewording for the sake of clarity, and so as not to assault the readers' eyes. (Or at least mine.)
I wish I knew when things are objects, values and instances, but I suppose I could make an educated guess and flag it with a TODO for the FPE. Would that be a process we could all agree upon?
Sent from my iPad
On Aug 21, 2015, at 5:48 PM, Greg Heo [email protected] wrote:
I hate the look of UIThings. While it looks particularly horrible here on GitHub issues, it's not too bad on the site and books.
It's extra wordy, but I try to write "UIThing objects" or "Int values" or "NSWhatever instances" as appropriate. I'm not always consistent at editing these out but I do it sometimes.
Some authors like to name types a lot, which means you run into this plural thing a lot:
In your UIViewControllers it's important to have references to other UIViewControllers to then draw to their UIViews inside all of their frames.
Personally, I think too many shifts to code style is distracting. A UITableView is a "table view" and unless the spelling out the exact class name is important, I'd rather write "table view".
In your UIViewController objects, it's important to have references to other view controllers to then draw to their views inside their frames.
β
Reply to this email directly or view it on GitHub.
from english-style-guide.
I could definitely agree with that process. If we're not sure how to rearrange, leave a TO-DO. We can also ask tech editors to keep an eye out for this.
from english-style-guide.
Related Issues (18)
- Should "document outline" be in title case instead? HOT 7
- American and British English spelling differences HOT 4
- Book punctuation vs free site content punctuation HOT 1
- Unity suggestions HOT 5
- Summary edit
- Path Forward Slash
- Menu Bar Items
- "top shelf" inserted in the midst of the "Terminal" entry HOT 1
- Control-Click or Control-click or control-click HOT 4
- Please correct sub title misspelling HOT 1
- Italicization of single letter variables and specifically Big O notation HOT 2
- Update Apple Style Guide link
- em dash usage clarification
- Misplaced Unity Guidelines HOT 2
- Integrating Unity Guidelines HOT 6
- Unity Terms & Capitalization HOT 6
- Editor/Inspector Capitalization HOT 8
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
π Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. πππ
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google β€οΈ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from english-style-guide.