Hi everyone!
Since a ton of blogs are being posted everyday and let's say not all of them are worth reading ●︿● , I decided to write this blog so that we could agree on some proper formatting or at least get some advice from experienced users.
Points that I find important while writing a blog ( not that my opinion matters anyway (¬_¬) ):
use:
- A proper title (using "I'm stuck on test 69!!!!" won't get you anywhere)
- Italics for Titles, Foreign Words, and Proper Names. ( not just for making your text look better )
- Simple English ( maybe some users aren't as good as you are )
- Your brain to figure out if your text can be misinterpreted ( this blog is a good example )
- A fresh topic as mentioned by CoffeeTime in here
- Proper code formatting as said by vovuh in here
avoid:
- Non-English or poorly written context ( probably like this blog ¯\_(ツ)_/¯ )
- Wasting time without getting a point across
- Bringing up topics that don't really concern the CodeForces community
- Bolding stuff without a reason
- Being toxic
- Pinging people when it's unnecessary ( Ari takes an honorable mention for this part )
- writing stuff that would be obvious if your IQ was above room temperature ( take my blog for an instance (ಥ﹏ಥ) )
don't forget to:
- TURN YOUR CAPS LOCK OFF
- (as Errichto suggested) DO NOT Say "sorry for my poor English", it's just a few seconds wasted for every reader. ⊙﹏⊙
- Get your point across with as few words as possible without dropping any details
- Preview your blog before posting it
- Follow basic punctuation rules as mentioned by -is-this-fft- in here
Also this is my personal opinion, but I think that blogs like this have the most appropriate formatting ~(˘▾˘~)
Anyways that was all I could think of at the moment, If you have any point worth mentioning please comment it and I'll add it ASAP.
Thanks for wasting your time on my blog (〃⌒∇⌒)
P.S. : As far as I know, this topic has only been discussed 6 years ago in here
Nice emoction btw XD
Please don't. It serves no purpose so it's just a few seconds wasted for every reader.
Thanks for wasting your time on my blog (〃⌒∇⌒)
it's same as
"sorry for my poor English"
, wasting readers time ಠ‿↼You got me there (・・;)
:pray: :sorz:
Thank you for these valuable tips, I hope to see beautiful blogs from now on.
As a sole member of soroush fan club I request people to start a orz chain.
soroush orz
soroush orz
Important thing IMO are some very simple punctuation rules.
.
,,
,?
,!
,:
..
,?
,!
or...
.So often I see messages like
while the following would already be so much better:
I was taught those in first grade. They are basically the same in every language that writes in Latin or Cyrillic script. And even if your native language uses some other script and you have not "formally" learned English, it still isn't hard to emulate what the other people are doing. And even if you can't, there are so few of those rules and they are so simple.
Basically it baffles me how so many people ignore those rules.
Thanks for your suggestion ⊂(・ヮ・⊂)
Speaking of messages, adding "sir" doesn't make your sentence more grammatically correct, just more annoying!
It is also important to make sure that your blog is new.
so that you won't end up asking for a solution of a task with an editorial like this.
Also please don't do what I did here.
Use proper code formatting instead of pasting it directly in the textbox, or provide a clickable link to the submission (use ideone if the code is not a solution to a problem). Explain what your code does (or add brief comments), use proper variable naming, spacing and indentation if possible.
I don't know why I write this, but, in my opinion, one really important thing is to correctly format your code and use spoilers. I saw a bunch of blogs and comments where people just copy their submission, paste it through ctrl+v and submit their comment thinking this is a good formatted and readable thing. Come on, guys, there are so many things to format your code correctly in the standard codeforces editor.
Use spoilers when you want to ask some help with your code, I don't really know if someone really likes to scroll a comment which takes the whole page in 1920x1080 resolution. Also, copy-pasting the code without defining correct html-rules which determine if it's really a code is a disaster.
Examples:
include <bits/stdc++.h>
using namespace std;
vector w, cnt; vector<vector<pair<int, int>>> g;
long long getdiff(int i) { return w[i] * 1ll * cnt[i] — (w[i] / 2) * 1ll * cnt[i]; }
void dfs(int v, int p = -1) { if (g[v].size() == 1) cnt[p] = 1; for (auto [to, id] : g[v]) { if (id == p) continue; dfs(to, id); if (p != -1) cnt[p] += cnt[id]; } }
int main() {
ifdef _DEBUG freopen("input.txt", "r", stdin); // freopen("output.txt", "w", stdout);
endif
}
Good formatting, yes? I don't think so. And now goes good one.
And even more, you can use inline code if you want to highlight some lines of your code separately. Like this: "Oh no, I had overflow in this line:
cur += w[i] * 1ll * cnt[i];
and when I fixed that I got accepted!"And Templates. If a 10 line code has a 100 line template, It's just annoying. Templates make codes hard to read. Please consider removing the template before posting.
Length is also a factor. Blogs like this need a bit more explanations or sth in does bounds ...
They just don't feel right.
Why am I the example for being toxic xD