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

Updating references to external content #40

Closed
contraexemplo opened this issue Oct 22, 2019 · 7 comments
Closed

Updating references to external content #40

contraexemplo opened this issue Oct 22, 2019 · 7 comments

Comments

@contraexemplo
Copy link
Contributor

@contraexemplo contraexemplo commented Oct 22, 2019

Our docs have few references to external documentation, but they are all pretty significant: they are either essays written by core contributors, or messages of support and approval from members. In special, since it our docs were first written, Open Collective has abandoned Medium and moved its blog to Ghost. Referencing the right links to the right content here is relevant to those who will discover this kind of content and wish to follow a RSS feed or subscribe to the newsletter. I believe we should update them accordingly.

@contraexemplo contraexemplo self-assigned this Oct 22, 2019
@contraexemplo

This comment has been minimized.

Copy link
Contributor Author

@contraexemplo contraexemplo commented Oct 22, 2019

@alanna I created an issue to expand on that question I asked on Slack. 😊

@alanna

This comment has been minimized.

Copy link
Contributor

@alanna alanna commented Oct 22, 2019

Great! Yes it would be best to update links to the new URLs. We left the old content on Medium but each has been copied to the OC blog and that's the main content location now.

@contraexemplo

This comment has been minimized.

Copy link
Contributor Author

@contraexemplo contraexemplo commented Oct 22, 2019

@alanna what do you think about getting a few new tweets of people talking about OC as well?

@alanna

This comment has been minimized.

Copy link
Contributor

@alanna alanna commented Oct 27, 2019

@contraexemplo new tweets would be cool! We have tweets in every newsletter so I would start by looking there for recent examples.

@contraexemplo

This comment has been minimized.

Copy link
Contributor Author

@contraexemplo contraexemplo commented Nov 19, 2019

Just found out that embedding tweets with GitBook is... not a good experience. When I get the code to embed it, they just convert it to plain text. Should I transform those into images or should I embed them like that, @alanna? See https://docs.opencollective.com/help/financial-contributors/organizations/sustainer-resources for two examples of how it embeds tweets.

@contraexemplo contraexemplo moved this from To do to In progress in Google Season of Docs 2019 Nov 19, 2019
@alanna

This comment has been minimized.

Copy link
Contributor

@alanna alanna commented Nov 20, 2019

@contraexemplo

This comment has been minimized.

Copy link
Contributor Author

@contraexemplo contraexemplo commented Nov 21, 2019

FYI, Twitter's new code for embedding content is not supported by GitBook yet. If your desktop UI was updated to the new one (which is similar to their mobile website), embedding tweets won't work. The code block they used to offer on the old UI, however, is still accepted by GitBook.

To revert to the old UI, you will have to use an add-on called GoodTwitter. It is available on both Firefox and Chrome. (I'm going to add this to the Suggesting changes page.)

@contraexemplo contraexemplo moved this from In progress to Done in Google Season of Docs 2019 Nov 28, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
2 participants
You can’t perform that action at this time.