Re:Open letter to all developers with blogs
by pixelbath on Wednesday October 09, 2019 @03:15PM
(#21206809)
I would also add:
No screenshots of code. I don't care if it's not syntax-highlighted, but I would like it to be in plain text, hopefully fixed-width.
If you're going to reference another blog, please include the relevant information in your own blog before the linked site goes down and I have to hope that site's owner didn't block archive.org from indexing it.
I'd like comments enabled, but I know some people have a hard-line stance against it (I was once told, "oh, you're thinking of a forum" when I suggested a developer add comments to their blog). Sometimes people smarter than me comment on my blog, and that adds value to my post when it has incomplete or incorrect information.
Re:Open letter to all developers with blogs
by CM30 on Friday October 11, 2019 @06:24PM
(#21229042)
I'd like to add that snippets of code presented as plain text should not be auto selected when someone clicks on them or what not, but should give the user the OPTION to copy the entire snippet as a separate button.
We don't always want to copy everything, we sometimes want to test out specific lines or what not. Don't mess around with how the select option works.
Re:Open letter to all developers with blogs
by mixedCase on Wednesday October 09, 2019 @03:50PM
(#21207206)
> Not that I disagree but isn't there a security risk with code that can be cut and pasted?
Yes if the blog author is malicious and the copy-paster inattentive. Don't even need an inattentive user if it's a command pasted in a terminal that will interpret the newline as <enter>.
Re:Open letter to all developers with blogs
by dragonwriter on Wednesday October 09, 2019 @08:33PM
(#21209726)
No. Not to the poster. And not any different to the recipient than code that can be retyped, downloaded, or reproduced by any other mechanism besides copy and paste.
In addition to interactivity, Epiphany implements version control, forking and pull request. You can collaborate with others just like you do on github.
An article will have two timestamps, Create time and last modified time. More than that, you can see the entire revision history.
Source code is in text and syntax highlighted.
It also has the social publishing feature as seen on Medium.
Finally, users own their content. Epiphany has a download button to allow downloading all blog data.
The format used by Epiphany, unlike that of Jupyter, is in plain text and is human readable.
Re:Open letter to all developers with blogs
by seisvelas on Thursday October 10, 2019 @11:24PM
(#21221279)
Sure! In the little tour it gives you, when it's describing the play button, I couldn't click Next or Finish because they were hidden behind the little tag input area. I just zoomed out on the page with CTRL + minus and was able to click.
I imagine you didn't notice this due to it being specific to my screen size (I'm on a macbook, I'm guessing you're using something else?)
Re:Open letter to all developers with blogs
by theandrewbailey on Wednesday October 09, 2019 @04:03PM
(#21207349)
I think that goes for everyone with a blog. And make sure that those dates have years! I've lost count of how many blogs only show the month and day of a post. "Mar 3" of 2019? Or is that 2009? I can't tell!
Re:Open letter to all developers with blogs
by jolmg on Thursday October 10, 2019 @05:44PM
(#21219488)
Thank you for giving me hope in my memory. Checking the Wayback Machine, it seems that putting absolute dates was a change that came some time after 2017. In 2017, HN post id=1 was dated "4027 days ago"[1].
Re:Open letter to all developers with blogs
by CM30 on Friday October 11, 2019 @06:27PM
(#21229057)
Eh, I think it's fine if said timestamp starts off as relative, but becomes an absolute timestamp after a while. For instance, quite a few forums I use have the timestamp for today's posts as 'posted today at [time], but it changes to 'posted yesterday at [time]' when its a day old, then eventualy to 'posted on [date] at [time] once it's about a week ago or so.
Re:Open letter to all developers with blogs
by jerriep on Wednesday October 09, 2019 @08:25PM
(#21209661)
Toptal is a big offender with this. I asked them before to do this and they declined. I understand there are some evergreen content out there, but anything related to technology does not fall into that category and having a date is important to understand if the content is likely out of date.
Re:Open letter to all developers with blogs
by CM30 on Friday October 11, 2019 @06:31PM
(#21229080)
I suspect a fair few of the people who do this are trying to trick search engines into thinking their content was posted more recently than it actually was, since a few SEOs did experiments and found content without timestamps/with misleading ones would sometimes rank higher than those with accurate ones.
That or they think it gets people thinking they post more regularly than they actually do.
But yeah, agreed. Especially given that software development is a rather time sensitive field, and what works/happens to be best practice at one point may not be so further down the line.
Re:Open letter to all developers with blogs
by tomaszs on Wednesday October 09, 2019 @04:16PM
(#21207501)
Oh i wrote last blog post 10 years ago? So sad. Swoosh. Evergreen enabled :)
Ps. Techcically speaking a set of articles without timestamps is not a blog
Re:Open letter to all developers with blogs
by dredmorbius on Wednesday October 09, 2019 @01:54PM
(#21205868)
Date or time, same thing.
A timestamp is useful for rapidly-cycling content, especially comment threads. If you're posting content less often than daily, a date stamp is sufficient, though if your site has multiple posts daily, go with timestamps.
"Sufficient granularity to distinguish content" should be your guiding principle.
Re:Open letter to all developers with blogs
by duxup on Wednesday October 09, 2019 @04:28PM
(#21207648)
Also n00bs like me... just don't offer code specific instruction about coding on your blog. Personal experiences, learning advice have at it, but if you really haven't done much coding.... please don't offer advice about it.
I hate to be so negative but the internet is awash with bad coding advice (and the same code copied from vid to blog and back again) that seems like resume fodder more than helpful.
The worst thing about learning is reading a post long enough to realize the other person is a noob too and their code is a malformed mess that the blog author doesn't really understand.
Re:Open letter to all developers with blogs
by amerkhalid on Thursday October 10, 2019 @03:40PM
(#21218407)
I have to disagree, I have learned from a lot of n00bs. I copied broken code and it didn't work, but it provided enough hints that I was able to make it work. I also posted back fixed code as comments on authors' blogs, and many would update their post with my code.
Same thing has happened on my blog, I have some super old Pentaho configuration posts, and every once in a while I get an email from someone saying my code is not right but they were able to make it work with some changes. Hence, I leave it up there.
No screenshots of code. I don't care if it's not syntax-highlighted, but I would like it to be in plain text, hopefully fixed-width.
If you're going to reference another blog, please include the relevant information in your own blog before the linked site goes down and I have to hope that site's owner didn't block archive.org from indexing it.
I'd like comments enabled, but I know some people have a hard-line stance against it (I was once told, "oh, you're thinking of a forum" when I suggested a developer add comments to their blog). Sometimes people smarter than me comment on my blog, and that adds value to my post when it has incomplete or incorrect information.
We don't always want to copy everything, we sometimes want to test out specific lines or what not. Don't mess around with how the select option works.
Not that I disagree but isn't there a security risk with code that can be cut and pasted?
Yes if the blog author is malicious and the copy-paster inattentive. Don't even need an inattentive user if it's a command pasted in a terminal that will interpret the newline as <enter>.
https://epiphany.pub/post?refId=2684bc94f9fcb9ffe637ebfbeba2...
Epiphany is a crossover of Jupyter notebook and Medium.com,
Not only can you write text, you can also program on it, to create interactive examples, see:
https://epiphany.pub/post?refId=4c411b8a0b5207739f97e787d2af...
In addition to interactivity, Epiphany implements version control, forking and pull request. You can collaborate with others just like you do on github.
An article will have two timestamps, Create time and last modified time. More than that, you can see the entire revision history.
Source code is in text and syntax highlighted.
It also has the social publishing feature as seen on Medium.
Finally, users own their content. Epiphany has a download button to allow downloading all blog data.
The format used by Epiphany, unlike that of Jupyter, is in plain text and is human readable.
disclaimer: I made Epiphany
I imagine you didn't notice this due to it being specific to my screen size (I'm on a macbook, I'm guessing you're using something else?)
I will resolve the issue this weekend.
I don't think the GitHub for the project is updated but from now on when I notice things I'll raise them as issues there :)
Also, not just blogs but everything ever posted online.
"17 minutes ago."
Or the top voted story on Oct 8, 2007 https://news.ycombinator.com/item?id=64795
Created used to show the number of days (I remember passing 3650), and now it shows the date. So the change was within the last year.
[1] https://web.archive.org/web/20171019104348/https://news.ycom...
That or they think it gets people thinking they post more regularly than they actually do.
But yeah, agreed. Especially given that software development is a rather time sensitive field, and what works/happens to be best practice at one point may not be so further down the line.
Ex: https://blog.mozilla.org/blog/2019/10/04/breaking-down-this-...
A timestamp is useful for rapidly-cycling content, especially comment threads. If you're posting content less often than daily, a date stamp is sufficient, though if your site has multiple posts daily, go with timestamps.
"Sufficient granularity to distinguish content" should be your guiding principle.
I hate to be so negative but the internet is awash with bad coding advice (and the same code copied from vid to blog and back again) that seems like resume fodder more than helpful.
The worst thing about learning is reading a post long enough to realize the other person is a noob too and their code is a malformed mess that the blog author doesn't really understand.
Same thing has happened on my blog, I have some super old Pentaho configuration posts, and every once in a while I get an email from someone saying my code is not right but they were able to make it work with some changes. Hence, I leave it up there.