yegor256 / blog

My blog about computers, written in Jekyll and deployed to GitHub Pages

This repository contains the sources of my blog: www.yegor256.com (the backup URL is this one).

My book 256 Bloghacks explains how this blog is built and maintained.

You are welcome to submit corrections to this blog. In order to do that, you will need Ruby 3.0+, Bundler, Woff2, and PlantUML installed. Then, run this:

$ bundle update
$ bundle exec jekyll serve

In a few minutes of building you should be able to see the blog at http://localhost:4000. Make your changes and refresh the page in the browser. If everything is fine, submit a pull request.

If it doesn't work (for some reason), do it via Docker:

$ docker build . -t blog
$ docker run -it --rm -v "$(pwd):/b" -p 4000:4000 blog \
  'cd /b && bundle lock && bundle update && bundle exec jekyll serve --trace --host=0.0.0.0'

blog's Issues

Create a list of non-technical/non-software books mentioned

Sometimes there's mention of non-software books on blog posts, podcasts, twitter or telegram but these are scattered.

Examples:

• https://www.amazon.com/Myth-Monogamy-Fidelity-Infidelity-Animals/dp/0805071369/ (telegram)
• https://www.amazon.com/Hiring-Geeks-That-Johanna-Rothman-ebook/dp/B00AUYNM38/ (podcast)
• https://www.amazon.com/Manage-Your-Slaves-Marcus-Sidonius/dp/1781252521/ (blog post)
• https://www.amazon.com/slide-ology-Science-Creating-Presentations/dp/0596522347/ (telegram)

These could be added to a single static page, easily accessible on the blog.

Bold text doesn't seem to be rendering right on the blog.

See this post:
http://www.yegor256.com/2018/04/24/right-way-to-report-bugs.html

The words "Victimize yourself" and "Push them" should be bold.

The raw md looks like this: **Victimize yourself** (Victimize yourself).

This bug appears on Windows 10 (Chrome, Brave) and Windows 7 (Chrome, IE).

@yegor256 say it works okay for him (presumably on Mac).

P.S. My entire world will collapse tomorrow if this isn't fixed... 😜

Link webinar "How to Cut Corners and Stay Cool (webinar #15)" to blog articles

Webinar no. 15 is linked to these articles:

• http://www.yegor256.com/2015/01/15/how-to-cut-corners.html
• http://www.yegor256.com/2015/02/16/it-is-not-a-school.html

I'm going to create a PR for it with adding this video to youtube param.

shift-m 28

rename Teamed to Zerocracy

Line number in code snippets

Maybe you will consider adding line numbers in code snippets? I think it will encrease readability of your posts. Just a suggestion.

disqus some posts lost

Wrong image size in "Incremental Billing" post

http://www.yegor256.com/2014/10/21/incremental-billing.html
Other images in this page look fine. I use Chrome on Mac OS.

shift-m 27

https

https://blog.github.com/2018-05-01-github-pages-custom-domains-https/

code ahead published

editorial error

In this article it says "There are a few arguments against "accessors" (another name for getters and setters)" but it should say "There are a few arguments against "accessors" (another name for getters and setters)" because setters are called "mutators".

Test method names

In

blog/_posts/2014/apr/2014-04-27-typical-mistakes-in-java-code.md

Line 110 in c280b45

comments start with 'can.' Additionally, method names shouldn't start with a

it is written:

Additionally, method names shouldn't start with a verb.

Example has verb as first word, something is wrong here.

Only JavaDoc comments start with 'can.'

They do not start with 'can', they start with class name.

start with can.Only

Space is missing

It's important to start the first sentence of your JavaDoc with the name of the class you're testing followed by can

Should be Javadoc. Moreover, do you think that word cannot is acceptable instead of can in Javadoc?

exclude index from sitemap

exclude it

rultor instead of travis

Copenhagen, Sweden?

The blog post

https://github.com/yegor256/blog/blob/033940f29bb56a81ee94fad7aa3f322d6ba01c29/_posts/2016/nov/2016-11-09-why-no-ebooks.md

the place is marked as Copenhagen, Sweden.

Copenhagen is in Denmark.

shift-m 33

add some more examples to Law of Demeter

This post isn't clear enough, what is the correct approach?
Some examples of the wrong approach?
This is a big factor in doing OOP correctly and I think this post could benefit from having a lot more information

blog/_posts/2016/jul/2016-07-18-law-of-demeter.md

youtube videos with key

update about-me

shift-m 32

russian boilerplate

more videos to articles

boilerplate

article about NULL

highlight menu

Anchor links are incorrect

Hi 256!

Example: http://www.yegor256.com/2015/08/04/nine-steps-start-software-project.html
Link to the Decisions and Alternatives: http://www.yegor256.com/#decisions-and-alternatives

webinar 37

shift-m 31

shift-m 28 script

Spammy structured markup

https://support.google.com/webmasters/answer/3498001?ctx=MAC

Links on '12 Best Articles' do not work

Links to articles on http://www.yegor256.com/best.html do not work - they link to the page itself. Let's fix them.

Put link on agenda from main page

I guess that it was like your personal plan on blog posts. Maybe add it as link on the main page?

shift-m 26

podcast 29

RSS feeds per tag

Let's add them

Wrong amazon link on "EO vol. 3"?

See http://www.yegor256.com/books.html.

There is an Amazon link on "Elegant Objects vol. 2" in the announced "Elegant Objects vol. 3 section. Was it done by mistake?

Update "OO input and output in Cactoos"

The Cactoos usages of post
https://github.com/yegor256/blog/blob/master/_posts/2017/jun/2017-06-22-object-oriented-input-output-in-cactoos.md need to be updated according to a recent Cactoos version.

Broken badge images

https://www.yegor256.com/pets.html

Images for Jare.io, S3Auth.com, Stateful.co, JCabi are not displayed

webinar 35

shift-m 25

The TDD That Works for Me does not have "tdd" tag

Please add one for better searchability.

http://www.yegor256.com/2017/03/24/tdd-that-works.html

https://github.com/yegor256/blog/blob/master/_posts/2017/mar/2017-03-24-tdd-that-works.md
does have "testing" tag but does not have "tdd".

shift-m 30

"Blame-Free Software Quality Control" article?

@yegor256, in a recent commit,

778a3e8#diff-e31d69d96d4f33e66b0802adab28a13f , you deleted an article entitled "Blame-Free Software Quality Control".

I believe the article's content is of value and there would be benefit to the community in having a post or a page with this content.

Was this in order to put it on an actual blog post?

place all pet projects into ProductHunt

No HTTPS connection to blog.

Seems HTTPS connection is not available at the moment:

shift-m 24

minor changes

shift m 34

No 'Access-Control-Allow-Origin' header

*chrome