Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Vo/remote work easier blog post #682

Open
wants to merge 7 commits into
base: master
from
Open

Conversation

@vanesa
Copy link
Member

vanesa commented Mar 22, 2020

Adds the blog post version of our Remote software development made easier white paper.

vanesa added 7 commits Mar 22, 2020
Copy link
Contributor

adaaaam left a comment

LGTM! :)


### Home office and desk setup

- **Separate work and home:** “Try working in a different space to where you relax/sleep.”

This comment has been minimized.

Copy link
@AnandChowdhary

AnandChowdhary Mar 24, 2020

Contributor

Any specific reason why all the bullet points have their descriptions in quotes? The Sourcegraph style guide recommends "[punctuation] goes outside of quotation marks" which this breaks. Also, personally,

  • Separate work and home: Try working in a different space to where you relax/sleep.

Is more readable than

  • Separate work and home: “Try working in a different space to where you relax/sleep.”

primarily because quotes have a well defined context (you're quoting someone), just like you're quoting Michael and Quinn in the later part of this post. I'd recommend getting rid of them, but I'd love to hear if you chose typestyle this for a particular reason that I'm missing.

This comment has been minimized.

Copy link
@vanesa

vanesa Mar 24, 2020

Author Member

The reason is that we are quoting our teammates. As mentioned in the paragraph above:
We have compiled some excellent tips and tricks from fellow [teammates](https://about.sourcegraph.com/company/team) on how to live your best distributed work life!
And regarding punctuation inside the quotes, our style guide states:
Punctuation goes outside of quotation marks, except in marketing when displaying a quote.
In this case, these are quotes.

This comment has been minimized.

Copy link
@ryan-blunden

ryan-blunden Mar 24, 2020

Contributor

I found this a bit weird as well, but love that we're using quotes from our teammates.

@vanesa What about reusing quotation format from our testimonials styles as you did with Nick's quote, as that would make it obvious more clear that we're using quotes from teammates, and would make the blog post more visual.

Otherwise, I think removing the quotes is fine.

This comment has been minimized.

Copy link
@AnandChowdhary

AnandChowdhary Mar 25, 2020

Contributor

Thanks, @vanesa! That makes a lot of sense, I missed that. Maybe then we can cite the quoter? Something like Separate work and home: “Try working in a different space to where you relax/sleep.” – Example name? Only because it's not necessarily clear that it's a quote without the citation; if we remove the quotation marks, it still works as independent points. You're the best judge!

This comment has been minimized.

Copy link
@vanesa

vanesa Mar 27, 2020

Author Member

@ryan-blunden yes I'm currently reformatting this post into the format we have for case studies also due to other reasons. I'll see how it looks if we remove the quotes.
@AnandChowdhary we tried that in the past with our pdf version and it just didn't work out because many of the quotes have multiple authors and it just looks very cluttered. Will see how the removal of the quotes work in the new format. Stay tuned 😄.

@@ -0,0 +1,125 @@
---
title: "Remote software development made easier"
author: Sourcegraph

This comment has been minimized.

Copy link
@ryan-blunden

ryan-blunden Mar 24, 2020

Contributor

We haven't done this before and it strikes me as being more corporate when it doesn't come from an individual.

Why not add your name, or Stephen's?

This comment has been minimized.

Copy link
@vanesa

vanesa Mar 27, 2020

Author Member

There were so many people involved in producing this content that I didn't want to take sole credit for it, but I understand if stating Sourcegraph also gives a wrong impression...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

4 participants
You can’t perform that action at this time.