Almanac.httparchive.org: Copyedit completed contents

[rviscomi]

Go through each chapter and "contentful" page to ensure that it fits our "work fun" voice, fix spelling and grammar, and finalize formatting. See the Editors' Wiki for an explicit list of best practices.

Whenever possible, also try to interlink chapters (#253).

• [x] 1. JavaScript #131 @obto
• [x] 2. CSS #132 @rachellcostello
• [x] 3. Markup #133 @rviscomi
• [x] 4. Media #170 @bazzadp
• [x] 5. Third Parties #134 @bazzadp
• [x] 6. Fonts #143 @bazzadp
• [x] 7. Performance #171 @rachellcostello
• [x] 8. Security #158 @bazzadp for first round + someone else
• [x] 9. Accessibility #155 @obto
• [x] 10. SEO #163 @rachellcostello
• [x] 11. PWA #164 @bazzadp
• [x] 12. Mobile web #147 @rviscomi
• [x] 13. Ecommerce #135 @bazzadp
• [x] 14. CMS #169
• [x] 15. Compression #145 @bazzadp
• [x] 16. Caching #172 @bazzadp
• [x] 17. CDN #149
• [x] 18. Page Weight #144 @obto
• [x] 19. Resource Hints #136 @rviscomi
• [x] 20. HTTP/2 #173 @rachellcostello
• [x] Methodology #202 @bazzadp
• [x] Home #212 @bazzadp
• [x] Foreword #285 @bazzadp

[rviscomi]

@ekharvey @Meggin @rachellcostello IIRC you've all expressed interest in helping out with copyediting. If you still have time over the next 3 weeks to review content, it'd be a huge help! 🙏

[rviscomi]

The following chapters are merged and ready for editing:

3. Markup
5. Third Parties
10. SEO
11. PWA
20. HTTP/2

Markdown files are available at src/content/en/2019.

Most of them still need data viz embedded but that shouldn't block.

[rachellcostello]

Of course, happy to help with proofreading and editing wherever needed! I can start off with the SEO chapter, but I can tackle some of the others as well so feel free to divide up the remaining chapters and assign me more.

[rviscomi]

Great thanks @rachellcostello! Yes, go ahead and start with the SEO chapter.

To make sure everyone is following the same guidelines I started a wiki page for us to drop in our editing decisions. As you go through the content and establish new editing rules, add them to the wiki.

[obto]

Currently reviewing and editing the caching, javascript, mobile web and a11y chapters. After those have been merged in, I'd be happy to edit the rest :+1:

[rachellcostello]

I've finished reviewing the SEO chapter and will work on Performance next, looks like that has just been merged

[rviscomi]

@rachellcostello after #249 is merged the Performance chapter should be ready for editing. Just had to rewrite it a bit and add data viz.

[bazzadp]

@rviscomi, @rachellcostello, @obto what do you think of https://github.com/HTTPArchive/almanac.httparchive.org/issues/253 that I've just raised? One to bear in mind as we copyedit the remaining chapters?

P.S. And sorry if that sounds like a dig at your chapter @rachellcostello - it honestly isn't meant like that!

[rachellcostello]

Not at all @bazzadp - I completely agree! I believe that placeholders were left for internal links as we didn't know what the final URLs would be for the other chapters, so it was a good example for you to reference :)

[rachellcostello]

I was going to proofread some other chapters while waiting for #249 to be merged, but looks like the list of finished chapters have other editors already assigned currently. I'll keep an eye out for any new chapters in src/content/en, but let me know if there's anything you need help with in the meantime @rviscomi and @obto

[rachellcostello]

Oh wait looks like HTTP/2 is ready, I'll take a look at that one too.

[bazzadp]

Be kind - that one’s mine! 😀 Ping me if you’ve any questions.

Can you do me a favour and correct my name in the meta data at the top from my twitter name (tunetheweb) to my GitHub name (bazzadp) since that’s the convention we’re going for?

Also now we know the URL structure as per https://github.com/HTTPArchive/almanac.httparchive.org/issues/253 if you could correct the other chapter links I have to those that would be good.

[rviscomi]

@obto since you wrote the mweb chapter I'll edit it with a fresh set of eyes :)

[obto]

That'd be great, and sorry for the delay in copyediting. I'll be starting
tonight and tomorrow

On Sat, Nov 2, 2019, 18:32 Rick Viscomi [e-mail] wrote:

@obto https://github.com/obto since you wrote the mweb chapter I'll
edit it with a fresh set of eyes :)

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/HTTPArchive/almanac.httparchive.org/issues/218?email_source=notifications&email_token=AAFHFS7P3UV6YL2JKFS5B4TQRYEXXA5CNFSM4JDKYGGKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEC5HJJY#issuecomment-549090471,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/AAFHFS6KE6ABZJI4VIZP4IDQRYEXXANCNFSM4JDKYGGA
.

[rviscomi]

The current list of chapters ready for editing are:

• Performance
• Accessibility
• Mobile Web
• Compression
• Caching
• Page Weight
• Resource Hints
• HTTP/2

A few more are wrapping up peer review and will be ready for editing soon.

I'm in the process of editing Mobile Web (#305). @rachellcostello have you started your review of HTTP/2 or Performance?

[bazzadp]

@obto I see you're down to Copy Edit the Caching Chapter. Want me to take that over since you were a reviewer on it? Fresh pair of eyes and all that. Plus I've already nitpicked @paulcalvano once for Compression so I'm sure he'd appreciate the same annoying guy giving him grief about his other chapter too! 😉

[obto]

@bazzadp That'd be great. I'll move straight to the JS chapter :)

[rviscomi]

@obto JS is not quite merged so maybe start on something else in case it changes.

[obto]

@rviscomi Oh that completely slipped my mind. I'll checkout page weight then

[rachellcostello]

The current list of chapters ready for editing are:

• Performance
• Accessibility
• Mobile Web
• Compression
• Caching
• Page Weight
• Resource Hints
• HTTP/2

A few more are wrapping up peer review and will be ready for editing soon.

I'm in the process of editing Mobile Web (#305). @rachellcostello have you started your review of HTTP/2 or Performance?

@rviscomi I'm working on HTTP/2 at the moment, should be finished today and I'll try and tackle Performance today too.

[rachellcostello]

Finished HTTP/2 and Performance, happy to take Page Weight and/or Resource Hints next.

[rviscomi]

Created an Editors team so we can bulk notify/assign now :)

cc @HTTPArchive/editors

[rviscomi]

JS and CSS are ready for editing.

[obto]

@rachellcostello Sorry i forgot to edit the list in here to show I've been working on page weight. Already halfway finished and a PR up.

[rviscomi]

Media and CMS are also ready for editing.

BTW this sheet is kept up to date (and is the source of truth) for the latest status of each chapter. All pending chapters with "Editing" status are fair game. Add your username to the checklist in the first comment to claim it.

Part | Chapter | Stage
-- | -- | --
I. Page Content | 1. JavaScript | Editing
I. Page Content | 2. CSS | Editing
I. Page Content | 3. Markup | Done
I. Page Content | 4. Media | Editing
I. Page Content | 5. Third Parties | Data Viz
I. Page Content | 6. Fonts | Editing
II. User Experience | 7. Performance | Done
II. User Experience | 8. Security | Editing
II. User Experience | 9. Accessibility | Done
II. User Experience | 10. SEO | Data Viz
II. User Experience | 11. PWA | Data Viz
II. User Experience | 12. Mobile Web | Done
III. Content Publishing | 13. Ecommerce | Data Viz
III. Content Publishing | 14. CMS | Editing
IV. Content Distribution | 15. Compression | Data Viz
IV. Content Distribution | 16. Caching | Done
IV. Content Distribution | 17. CDN | Peer Review
IV. Content Distribution | 18. Page Weight | Done
IV. Content Distribution | 19. Resource Hints | Editing
IV. Content Distribution | 20. HTTP/2 | Done

[bazzadp]

I've added some of the steps I'm doing to the Editor's Wiki.

In part to remind myself, in part for future, and in part in case someone comes a long and offers to help this weekend!

Free free to add to it!

[rviscomi]

@rachellcostello have you had a chance to edit the Media chapter?

[bazzadp]

@rachellcostello have you had a chance to edit the Media chapter?

Spoke to @rachellcostello and she's travelling so I said I'd take first pass at this, after I fix the typos in https://github.com/HTTPArchive/almanac.httparchive.org/issues/460.