Code Monkey home page Code Monkey logo

Comments (13)

plaindocs avatar plaindocs commented on August 10, 2024 2

Thanks for kicking off this discussion @theletterf

I think all we'd need to "get started" is a "Blog" subdirectory, published under writethedocs.org/blog

@mjang, you mean, like https://www.writethedocs.org/blog/ :-D

I think before getting stuck into technical details we need to figure out what need we're solving here. I think firing up your own blogging site isn't too hard in this day and age, so the community aspect of centralizing posts by different authors would be the benefit here.

Then again, nobody who isn't blogging because of the overhead wants someone else standing between them and publish.

I'd certainly be happy with an expanded Community Content section of the existing "blog", but we could also split them out entirely I think.

@ericholscher thoughts?

from www.

mjang avatar mjang commented on August 10, 2024 1

I love the idea. More than once, I've had posts in our Slack where people have suggested that I go further.

We have an incredible collective expertise that we should document -- and we have the skills!

To start (with the simpler option)

a centralized blog under WtD domain, with contributors drawn from the community and a certain level of editorial curation (WtD Blog)

I think all we'd need to "get started" is a "Blog" subdirectory, published under writethedocs.org/blog

from www.

plaindocs avatar plaindocs commented on August 10, 2024 1

Oh, and the name almost certainly needs to change. Writing about writing the docs is still light hearted.

from www.

plaindocs avatar plaindocs commented on August 10, 2024 1

@mjang thanks for replying specifically. I think that's the needle I'm trying to thread, is that a "WTD blog" can mean a lot of things to a lot of people, so the more specific folks are about what would be helpful, the easier it will be.

from www.

flicstar avatar flicstar commented on August 10, 2024 1

Following with interest, and tagging @ryanmacklin as well.

Over at The Good Docs Project, we recently launched a blog with the aim of tech writing advocacy, and we intended for it to be a platform where tech writers from the community could be published...

I love the idea of a Write the Docs community blog, and if/when it gets off the ground, it may be that our project adjusts the vision for our blog (to be more project-centric, to be more template specific 🤷).

from www.

ericholscher avatar ericholscher commented on August 10, 2024 1

I'm 👍 on having more community-contributed content on our site in some fashion. I'm generally -1 on hosting some kind of blogging platform. Tooling isn't what is stopping people from writing, but distribution & branding is valuable, and that's what we can provide.

I have some questions on cadence, editorial aims, payment, and many other things, but I think overall this is definitely something worth doing. I think the big thing that would be required to start is a small group of people to write up a WEP that proposes the process we'd follow to evaluate incoming content. I'd imagine it being similar to our talk selection process, and with a defined cadence? I'd imagine something monthly, and have it get promotion in the newsletter as well?

Another option that this could start with is a "community highlight" section of the newsletter, if we wanted to lower the barrier to shipping it, and tie it to an existing process that we already know works. Promoting existing content people already wrote is much easier than trying to get them to publish it on our domain, I'm guessing.

from www.

ryanmacklin avatar ryanmacklin commented on August 10, 2024 1

Following with interest, and tagging @ryanmacklin as well.

Over at The Good Docs Project, we recently launched a blog with the aim of tech writing advocacy, and we intended for it to be a platform where tech writers from the community could be published...

I love the idea of ways of WTD having community-contributed material! This is a quality group of thought leadership.

We decided on a blog for Good Docs Project because, while our core mission is to help devs and new writers with quality templates and supporting material, there's other advice that would help people accomplish their documentation goals. Basically, what can we share to help those interested learn to think like writers? That's the question and overall jam of the blog we're very slowly) rolling out. We're allowing for other topics, because we're all volunteers and the project also covers other side objectives, but that's our main thrust.

I say that to say: whatever WTD creates, consider the core theme and mission of it. A blog that works like a scattergun will serve most people once, but might not have the "do one thing well" approach this group hits well when it comes to the conferences.

I dunno if that makes sense, but hopefully to some it does. I worked in periodical publishing for years, and saw how an org (that was paid for their jobs, so not the same as volunteers managing extracurricular energy) can create a curated content pipeline. It's not easy—which is why GDP's blog has been slow to get going—but I believe it has promise.

If anyone would like to chat publication pipelines with me sometime, I'm happy to hang! I'm @macklin on WTD and GDP Slacks. (And I'd definitely love to talk with anyone who has pub pipeline experiences, to learn from you!)

from www.

ryanmacklin avatar ryanmacklin commented on August 10, 2024 1

Also (as a separate comment): some sort of platform for showcasing blog posts or whatever—whether or not it's an internal blog system or as links in a newsletter or whatever—could also work to elevate some local WTD Meetup communities. Like "Check out what Rose WIlliams from WTD Florida & Boston has to say about 'Getting Stakeholders on your side.'"

Since WTD already does that in a sense with Meetup talks (notably the Quorums), this could be great for other ways to showcase the community. And maybe that's all that's needed for now: a way to submit "hey maybe share my post" that your newsletter and social media can promote. That's less work (but not zero work) that having a publishing pipeline with QA/moderation, and doesn't bring into question things like "do we have a commenting system?" or "what's our tag architecture?" or "what's our review and acceptance policies?" and other logistics you'd want to think about if you set up your own system.

(I saw that as someone who had to, and still has to, answer those questions and more.)

from www.

CBID2 avatar CBID2 commented on August 10, 2024 1

I think Hashnode could be a good site. They have a team blog option and it looks pretty good.

from www.

mjang avatar mjang commented on August 10, 2024

For me personally, we're "solving" the impostor syndrome associated with blogging.

I can see a benefit to Write the Docs as well, as it could serve as a source of collective community intelligence.

from www.

theletterf avatar theletterf commented on August 10, 2024

JetBrains just launched their tech writing blog: https://blog.jetbrains.com/writerside/

from www.

djwfyi avatar djwfyi commented on August 10, 2024

Wordpress and https://writefreely.org are two options for creating a blogging community. Both can integrate into the Fediverse moment currently happening, too.

from www.

CBID2 avatar CBID2 commented on August 10, 2024

Has the platform been finalized yet?

from www.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.