search

jkup / awesome-personal-blogs

A delightful list of personal tech blogs
2.99k stars 238 forks source link

What should the list look like? #43

Closed jkup closed 4 years ago

jkup commented 5 years ago

Hey @fjoshuajr @lipis @hugmanrique @aletaschner

All of you submitted awesome ideas for what the list should look like! PRs were coming in so fast yesterday it kind of got lost in the shuffle so I was hoping to move the conversation into a single thread.

My thinking was:

  1. Make it a Markdown table
  2. Maybe a separate table for each letter of the alphabet?
  3. Add at least a field for what subjects the person talks about

How does that sound? Should we do something different? Hope you don't mind but I'm gonna close the other issues in favor of discussing it all in here!

Thanks!

fjoshuajr commented 5 years ago

Sounds good. Based on the previous PR's, something like this?

A

Author Areas of Interest
Adam C. Conrad Frontend, UI, UX
Adam Rackis
Angie Jones
Angus Croll
Aditya Rohilla
Ali Spittel
Amit Merchant
Andy Bell
Anton Medvedev
Antonin Januska
colinrobertbrooks commented 5 years ago

It might be a good idea to have a predefined key for "Areas of Interest" so it doesn't get unwieldy (something like all-contributors has, but maybe not emojis).

lipis commented 5 years ago

I would say area of interest/background something about the author and the description of the blog (as it was already recommended, we can get this info from the open graph).

Not sure if it makes sense to split them in groups as most people I would assume will just try to cmd+F (or ctrl+F) to find the desired keyword or name.. Also there is a question if we should split them by first name or last :)

aletaschner commented 5 years ago

In my humble opinion it is uglier with tables, I like the awesome-electron kind of way.

I agree with the sorting because as the list grows it would become a big mess without sorting.

And about descriptions / area of interest seems like a good idea to have both if possible.

lipis commented 5 years ago

On a second thought.. with prettified tables every diff might be ugly..

pauloxnet commented 5 years ago

Maybe when can use a definition list for every letter.

Awesome Personal Blogs Awesome

A delightful list of personal tech blogs

Personal Blogs

TOC

A

Adam C. Conrad
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Adam Rackis
Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

...

...

P

Paolo Melchiorre
#Python developer #Django contributor #Conference speaker #Remote worker #GNULinux user #FreeSoftware advocate
PC Maffey
Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
SandroMiguel commented 5 years ago

What about the language of the blog? My blog is in Portuguese. Can I also add it to the list?

antonmedv commented 5 years ago

What about adding screenshots? Will be cool.

evangrim commented 5 years ago

One index sorted by name and another sorted by topic?

lipis commented 5 years ago

Let's just not make it Yahoo! directory.. suppose to be a curated list of blogs..

https://s3.amazonaws.com/images.seroundtable.com/yahoo-directory-1997-1411992701.png

antonmedv commented 5 years ago

Definitely add short info about blog and what author is writing about (Like tags: php, nodejs, devops, etc).

royemosby commented 5 years ago

I would also include company currently (and team if applicable)working for.

cpl commented 5 years ago

How about having multiple .md files, each one covering a different approach in ordering the blogs (eg, based on: tags, language, companies, etc) and on the main page we can have a directory of letters, and alphabetically sorted blogs (by blog name or author, depending on the blog type). Each blog should be accompanied by a short description (impose a min and max char limit). This way we keep things nice and clean, people can easily find the blogs that could potentially interest them the most without creating a monolithical table with tens of columns. A nice extra feature could be a "top picks" selection at the top of the README, this could rotate some interesting or "hot" blogs (could be hard to determine what goes there).

lipis commented 5 years ago

What is needed is to have a JSON file with info (name, link, company, area, description, etc) and then a script that will generate the md file or multiple files. People will update only the JSON and the bots will be updating the md files on every PR, via Travis CI.

cpl commented 5 years ago 
{
    "name": "Awesome Blog Name",
    "owner": "Jon Doe",
    "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
    "url": "https://example.com",
    "tags": ["low level", "backend", "security"],
    "company": "Lorem Ipsum Inc.",
    "languages": ["en", "ro"]
}

Anybody wish to extend on this? We should also enforce a limit on the number of tags and description. If we have this format we can then generate the .md's for each filtering (@lipis) category or even have a static generated website using Jekyll.

Opinions @jkup ?

chrisaldrich commented 5 years ago

I've seen a few somewhat similar directory projects like this that might have some useful ux/ui/design ideas:

For additional metadata, one could run a microformats parser on the homepages of these sites and return social media presences in other locations using XFN's rel="me" set up. Something like this is done by Jeremy Keith on his Huffduffer.com service where one signs up and inputs one's website. His service then doesn't need to ask for Twitter, Facebook, or Github handles explicitly. Instead it relies on the service going to the homepage listed and pulling out the rel="me" values and doing it automatically on their behalf. Since many web platforms have this microformat value it can make the data acquisition easier and less manual in many cases.

(Originally posted at https://boffosocko.com/2019/03/27/55747316/)

jkup commented 5 years ago

Hey! So sorry I've been away and missing out on this great conversation. I promise I'll catch up in the next day but these ideas are great!