HN Personal Websites Directory (HNPWD) is a community-maintained
directory of personal websites by members of the Hacker News (HN)
community, along with an OPML file containing their RSS feeds. Please
visit the following link to view these resources:
Please check whether a website meets the following criteria before
requesting its inclusion in the directory:
The website must be a personal website, where the author of the
website has full control of its design and content. Websites
hosted on personal domains clearly qualify. Websites hosted on
services such as Neocities, GitHub Pages or Codeberg Pages also
qualify, as these platforms allow full control over the site's
design. However, blogs hosted on publishing platforms such as
Medium or Substack do not qualify.
The website must contain substantive content such as articles,
blog posts, projects or games developed by the author. Websites
that consist only of a CV or portfolio are not suitable for
inclusion in our directory. This requirement helps keep the
directory interesting and meaningful, and prevents it from
becoming a collection of minimal or placeholder websites with
little value to the community.
Add the website details to pwd.lisp and submit a pull request.
An example entry is provided at the bottom of the pwd.lisp
file and can be copied and modified as a starting point. When
creating a pull request, please follow these guidelines:
Keep all website entries sorted alphabetically by name.
Ensure that the bio text does not exceed 80 characters.
End the bio text with a full stop (period).
Do not use ampersand ('&') in the bio text. Write the word 'and'
instead.
Do not use Oxford comma (serial comma) in the bio text. That is,
do not write:
Writes about C, C++, and Go.
Instead, write:
Writes about C, C++ and Go.
Separate two sentences by double spaces. That is, do not write:
Game developer. Writes about computer graphics.
Instead, write:
Game developer. Writes about computer graphics.
Begin URLs with http:// or https://.
If a URL points to the root directory, include the trailing slash.
For example, write https://example.com/ (nothttps://example.com). This avoids an extra redirect for many
clients.
If certain information is not available or should not be included,
remove the corresponding property entirely. For example, if no
'about' link exists, delete the entire :about line from the
entry.
While we recommend that you follow these guidelines, do not worry too
much about getting everything right on the first attempt. Automated
checks run on every pull request and if you miss something, the
failing checks will tell you what needs fixing.
Aside: The 4th (no Oxford comma) and 5th points above (double spacing
convention) are likely going to feel awkward to many people. This
project uses British English (BrE) and Oxford comma is generally not
used in BrE. Further, the original author of this project uses Emacs
and has configured it to follow the rather old convention of
separating sentences with double spaces. As a result, we require
sentences to be separated by double spaces here as well. Yes, you
lose some precious bytes for your 80 character bio. Consider it the
price you pay for including your website in this directory.
If creating a pull request is too much hassle for you, create an
issue instead and post the website details in the following
format:
```
(:name "Your first name and last name"
:site "https://example.com/"
:blog "https://example.com/blog/ (Only if you have a separate blog URL)"
:feed "https://example.com/feed.xml"
:about "https://example.com/about/"
:now "https://example.com/now/"
:hnuid "example (Your HN user ID)"
:bio "A brief third-person description of yourself, not exceeding 80 characters.")
```
While creating the issue, do follow all the guidelines mentioned in
the previous section.
How is this different from the OPML available at
outcoldman/hackernews-personal-blogs?
The OPML file there is more comprehensive. It currently includes
over 1200 RSS feeds, whereas our project only has a small number
of entries so far. We hope that, with contributions from
community members, our list will grow over time. An important
goal of this project is to maintain the list of websites together
as a community.
This project also goes beyond providing an OPML file. In addition
to the OPML, it offers a website that lists the
websites individually along with a short bio of each author.
Why did you not start by importing
outcoldman/hackernews-personal-blogs?
We have not yet had the time to do so. The data format
used by this project differs from theirs and requires additional
information for each blog entry. Translating the existing list
into our format therefore takes a non-trivial amount of effort,
which we have not been able to commit to yet.
Contributions that add entries to this project, whether sourced
from that list or elsewhere, are very welcome.
This is free and open source software. You can use, copy, modify,
merge, publish, distribute, sublicence and/or sell copies of it, under
the terms of the MIT Licence. See LICENSE.md for details.
This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
express or implied. See LICENSE.md for details.
To report bugs or ask questions, create issues.
Alternatively, you can also join our IRC channel #hnpwd on
Libera Chat to ask questions or just generally hang out with the
community.