comments   21121

« earlier    

The Art of Comments
I believe commenting code is important. Most of all, I believe commenting is misunderstood. I tweeted out the other day that "I hear conflicting opinions o
programming  comments  code 
7 days ago by tedw
Coding Without Comments
Junior developers rely on comments to tell the story when they should be relying on the code to tell the story. Comments are narrative asides; important in their own way, but in no way meant to replace plot, characterization, and setting.
programming  comments  career 
7 days ago by jefframnani
KSS · Knyle Style Sheets
Documentation for any flavor of CSS that you’ll love to write. Human readable, machine parsable, and easy to remember.
css  documentation  styleguide  comments  sass 
11 days ago by spaceninja
SassDoc is to Sass what JSDoc is to JavaScript: a documentation system to build pretty and powerful docs in the blink of an eye.
css  documentation  sass  comments  styleguide 
11 days ago by spaceninja
8 Best Practices for Perfect CSS Documentation
In the world of CSS, documentation is underused. Since documentation is not visible to the end user, its value is often overlooked by clients. Also, if it’s your first time documenting code, it can be difficult to determine what to document and how to do it most effectively.
fridayfrontend  css  documentation  comments  bestpractices  system  sass 
11 days ago by spaceninja
gka/schnack: 🗣️ Simple node app for Disqus-like drop-in commenting on static websites
schnack - 🗣️ Simple node app for Disqus-like drop-in commenting on static websites
14 days ago by geetarista
Semantic Linefeeds
By starting a new line at the end of each sentence, and splitting sentences themselves at natural breaks between clauses, a text file becomes far easier to edit and version control. Text editors are very good at manipulating lines — so when each sentence is a contiguous block of lines, your editor suddenly becomes a very powerful mechanism for quickly rearranging clauses and ideas.
html  writing  documentation  comments  semantics  diffs  git 
15 days ago by spaceninja

« earlier    

related tags

#9;  2017  2018  39  accessibility  activism  add  advice  ai  amazing  amazon  analysis  and  app  apple  audio  bestpractice  bestpractices  bill  birb  blog  blogging  bots  bradbicedotcom  c  california  capitalism  career  clipblog  cloudcomputing  code  coding  commandline  comment  commentary  commenting  commit  community  contact  contactform  content  css  dark.patterns  dark.ux  database  databases  defect  democracy  development  diffs  discourse  discussion  disqus  diy  documentation  done  dopamine  dynamic-land  e  elections  email  employment  engineering  erickson  excel  facebook  fake  fcc  feedback.  fieryballsofdeath  form  forum  forward  free  fridayfrontend  future  git  golang  golanguage  good  goodread  hacker-news  hackernews  hardware  highavailability  hiking  hn  homeautomation  how  howto  html  human  humans  humor  illusions  infosec  intel  interesting  interview  it.  itp  javascript  jobs  jobsearch  journalism  js  language  law.enforcement  ldap  lethal  like  linguistics  links  linux  magic  mail  markdown  marketing  measurement  mesh.networking  message  misconduct  moderation  monetization  monitoring  move  music  net.neutrality  net_neutrality  networks  news  nodejs  nosql  notes  online  opensource  package  people  perl  php  physics  plugin  police  portland  postgres  privacy  productivity  professional  programming  project  prometheus  propaganda  psn  psyhchology  recording  reddit  redis  research  review  reviews  sass  scale  science  scraping  screencastomatic  security  semantics  sheet  shopping  sloppy  smbc  snark  software  spam  spyware  sql  sqlite  students  styleguide  sublimetext  surveillance.capitalism  surveillance  synth  system  tea  teaching  then  thoughtfulcomments  time  tips  to  tokindle  tool  tools  toread  training  tripadvisor  understand  usa  video  violence  vulnerability  wcag21  web  webmentions  wisdom  without  wordpress  wp-plugins  writing  yelp  your  yourself  youtube 

Copy this bookmark: