[blog] moved blog files to posts sub dir

[nwanduka]

In this PR, I:

• Created a posts/ subdirectory inside blog-post/.
• Moved all existing blog post content files into posts/.

[sysadmind]

This breaks the build. I think there are some other pieces missing if we move all these files. For example, we are looking at the blog-posts/ directory in this helpers file - https://github.com/prometheus/docs/blob/main/src/blog-helpers.ts#L5

[nwanduka]

@sysadmind you're right. thanks for pointing it out.

[sysadmind]

LGTM

[sysadmind]

@juliusv you had the feedback on the previous PR, do you want to weigh in on this one?

[bwplotka]

I'm sorry for challenging this, but what are the rationales? 🙈

The directory is called blog-posts. Now it will be blog-posts/posts. Is there a reason to duplicate posts naming here? Additionally blog-posts will not have any more files (other than README). Are we not making it harder to contribute blog posts with this change? 🤔 Maybe I miss context, do you mind @nwanduka to explain some long term plan for this change in this PR?

[juliusv]

I guess it all goes back to the discussion I started at #2718 (comment) - I don't mind that much whether the blog post instructions file is in the root or in a blog-specific subdir, I just found it cleaner to not have it in the same directory as all the blog post files themselves, since that requires an explicit code-level exception and also makes the new file harder to find by a human if it's in the same dir as all the blog post content files.

But yeah, maybe just calling the first dir blog/... and the content dir blog/content or blog/posts would be even clearer. Or just keep the new blog instructions in the repo root, I don't mind much either way :)

[bwplotka]

If we are doing this, let's also remove the filter from line 38 🙈

Also maybe blog/posts might be clearer (as @juliusv mentioned)

[bwplotka]

Ah got it, I didn't see the previous discussion on my fix.

Then let's remove the filter which seemed to be the main reason why we are moving files here (:

Sounds like we have two options here then (happy with both)

A) Change dirs, remove coding filter.

• Move posts to blog/posts (instead of blog-posts/posts)
• Move README to blog/README.md
• Remove filtering introduced in fix: fix build by allowing README file in blog dir #2718

B) Do nothing (:

Thanks for helping @nwanduka!

[juliusv]

Yeah, the previously introduced special-case filtering should be removed now. Then let's do option A I would say.

[nwanduka]

Thanks a lot everyone (@sysadmind @bwplotka @juliusv) for reviewing and leaving your feedback. I appreciate it. I've made the necessary changes (that's option A) and I think this PR is ready for a final review.

[bwplotka]

Thanks!