Craft

Publishing & Formatting

The work is not done when the code is written. It is done when the post is published and people can find it.

Setup

Author Setup

Before your first post, add yourself to the blog authors list at github.com/saeloun/blog/_authors.

Include: name, profile photo, bio, GitHub link, and social links.

Formatting

Code & Images

Use syntax highlighting with the correct language identifier:

{% highlight ruby %}

Rails.application.secrets.mailer_default_from_email

{% endhighlight %}

Add line breaks before and after code blocks. Add spaces around operators. a + b not a+b.

Images go in the images folder. Always include meaningful descriptions. Run the blog locally before submitting your PR to check images render correctly.

Review

Before You Submit

  • Run grammar checks (Grammarly, LanguageTool, or your editor's built-in checker).
  • Verify all links work.
  • Ensure the file name date matches the publishing date.
  • Preview locally if the post includes images.

Promotion

After Publishing

Sana shares posts through Saeloun's official accounts. You should also share using your personal accounts.

Ruby/Rails posts: Ruby Reddit, Rails Reddit, RubyFlow, Hacker News.

JavaScript posts: JavaScript Reddit, ReactJS Reddit.

Company accounts: RubySocial.