12 ms·

Do you mind giving examples with links?

by alpb 7y ago

spiderfarmer 7y ago
Not a Googler, but a literal quote from this article: "As always, I prefer using screenshots over gists in my articles to show code. I find them easier to work with, and easier to read." https://medium.com/@greg.perry/a-design-pattern-for-flutter-db6ccaea2413 https://medium.com/@greg.perry/a-design-pattern-for-flutter-...
- alpb 7y ago
  Yeah I don't think you can control how people write blog posts. The Flutter community on Medium (https://medium.com/flutter-community https://medium.com/flutter-community) seems to be a collection of articles mostly written by non-Googlers.
- thesandlord 7y ago
  As a Googler who has a lot of technical content on Medium, I have to agree that screenshots are much more flexible than Medium's gist support, but I always add a link to the actual code right under. For example: https://medium.com/google-cloud/kubernetes-configmaps-and-secrets-68d061f7ab5b https://medium.com/google-cloud/kubernetes-configmaps-and-se... In this example, I have a single gist with multiple files, but Medium can't display just a single file from that gist at a time (maybe things have changed, but I don't think so). Medium's gist and code support in general is sub-par compared to other platforms IMO, but as a platform it does make it easy to create and share content that is also easily discoverable. I'm probably going to start hosting the canonical post on my own domain and just use Medium to syndicate it.
  - spiderfarmer 7y ago
    I noticed that in a lot of articles example code is just missing, like this one, on mobile: https://medium.com/flutter-community/flutter-redux-toast-notification-fcd0971eaf0f https://medium.com/flutter-community/flutter-redux-toast-not... I don’t know who’s to blame here but I already hate Medium with a passion and this is not helping.
- jorams 7y ago
  The weirdest thing about that quote is that the screenshots in the article are all very low quality and hard to read. Maybe Medium just needs a better way to handle code samples.

Do you mind giving examples with links?

by alpb 7y ago

Do you mind giving examples with links?

Not a Googler, but a literal quote from this article: "As always, I prefer using screenshots over gists in my articles to show code. I find them easier to work with, and easier to read." https://medium.com/@greg.perry/a-design-pattern-for-flutter-db6ccaea2413 https://medium.com/@greg.perry/a-design-pattern-for-flutter-...

alpb 7y ago
Yeah I don't think you can control how people write blog posts. The Flutter community on Medium (https://medium.com/flutter-community https://medium.com/flutter-community) seems to be a collection of articles mostly written by non-Googlers.
thesandlord 7y ago
As a Googler who has a lot of technical content on Medium, I have to agree that screenshots are much more flexible than Medium's gist support, but I always add a link to the actual code right under. For example: https://medium.com/google-cloud/kubernetes-configmaps-and-secrets-68d061f7ab5b https://medium.com/google-cloud/kubernetes-configmaps-and-se... In this example, I have a single gist with multiple files, but Medium can't display just a single file from that gist at a time (maybe things have changed, but I don't think so). Medium's gist and code support in general is sub-par compared to other platforms IMO, but as a platform it does make it easy to create and share content that is also easily discoverable. I'm probably going to start hosting the canonical post on my own domain and just use Medium to syndicate it.
- spiderfarmer 7y ago
  I noticed that in a lot of articles example code is just missing, like this one, on mobile: https://medium.com/flutter-community/flutter-redux-toast-notification-fcd0971eaf0f https://medium.com/flutter-community/flutter-redux-toast-not... I don’t know who’s to blame here but I already hate Medium with a passion and this is not helping.
jorams 7y ago
The weirdest thing about that quote is that the screenshots in the article are all very low quality and hard to read. Maybe Medium just needs a better way to handle code samples.