# Write documentation PRs not blog posts

**URL:** <https://discourse.julialang.org/t/write-documentation-prs-not-blog-posts/100942>\
**Category:** Teaching & Outreach\
**Tags:** discussion\
**Created:** [June 28, 2023, 6:32pm UTC](https://discourse.julialang.org/t/write-documentation-prs-not-blog-posts/100942 "2023-06-28T18:32:11Z")\
**Posts on this page:** 1\
**Showing post:** 9

<div class="post-metadata">

**Author:** ![mkitti](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mkitti/32/12459_2.png) [@mkitti](https://discourse.julialang.org/u/mkitti)\
**Post date:** [June 29, 2023, 4:30pm UTC](https://discourse.julialang.org/t/write-documentation-prs-not-blog-posts/100942/9 "2023-06-29T16:30:26Z")

</div>

Two points on this.

1. If the core developers of the package are also the authors of the blog post, a pull request can be a formal way to seek permission to reuse the text or content. If the blog author is a third party, they can also be tagged in the pull request and explicitly asked for permission.

I would be extremely transparent about where content originates from and who wrote it. It’s also possible to restate or paraphrase the content, although this must be done carefully.

1. While the core developers are likely the most qualified to write the documentation, they probably have the least amount of time to write it. They are likely also the most qualified to write new code.

If there is something I can do to provide a developer with a one-click merge button to advance the state the project, _I_ figure out how to do it. If cannot, I create an issue.

Adapting, John F. Kennedy’s phrasing “Ask not what open source core developers can do for you – ask what you can do for your open source core developers”.

Yes, I acknowledge the hurdles above, but I think there are ways to lower them. One tactic I have used is to solciit documetation help here on Discourse.

For example, see

> [@Updating documentation for Interpolations.jl v0.14](https://discourse.julialang.org/t/updating-documentation-for-interpolations-jl-v0-14/84082):
>
> Hello. I’m the current maintainer of [Interpolations.jl](https://github.com/JuliaMath/Interpolations.jl). We recently released [v0.14.0](https://github.com/JuliaMath/Interpolations.jl/releases/tag/v0.14.0). I would like to follow up with a point release with a focus on the documentation, and I could use your help. [JuliaHub tells me that there were 9300 new users in the last 30 days.](https://juliahub.com/ui/Packages/Interpolations/VpKVx/0.14.0) I’ve started some changes via this [pull request #499](https://github.com/JuliaMath/Interpolations.jl/pull/499). Here is a preview: Documentation: [Home · Interpolations.jl](https://juliamath.github.io/Interpolations.jl/previews/PR499/) README.md: [Interpolations.jl/README.md at mkitti/update\_docs · JuliaMath/Interpolations.jl · GitHub](https://github.com/JuliaMath/Interpolations.jl/blob/mkitti/update_docs/README.md) NEWS.md: [Interp…](https://github.com/JuliaMath/Interpolations.jl/blob/mkitti/update_docs/NEWS.md)

---

_[View the full topic](https://discourse.julialang.org/t/write-documentation-prs-not-blog-posts/100942)._