Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

The ability to function as either a standalone forum, or as a disqus style comment add on for an existing blog is neat.

Is there documentation somewhere? I can see it has some kind of spam protection by skimming the source code, but I don't see any docs.



I believe Discourse can do this as well, as least they did something like it for a while on their blog posts.


Yes, look here, CodingHorror's (Jeff Atwood) blog:

https://blog.codinghorror.com/the-rise-of-the-electric-scoot...

the comments in the comments section, are from Discourse. Here's that Discourse forum: https://discourse.codinghorror.com/t/the-rise-of-the-electri...

A difference between Talkyard and Discourse, for blog comments, is that Talkyard is threaded, like Disqus. So when people start talking about different things related to the blog post — start different "sub topics", then, with Talkyard, each such sub topic gets its own sub thread,

... Whilst with Discourse, all sub topics are mixed together into one single flat layout.

And, with Talkyard and Disqus etc, the more interesting (more popular) sub topics are shown first, whilst with Discourse, it's whoever happened to type the first comment, who is shown first.


Sorry, there is barely any documentation yet.

What things would you want me to focus on, when adding documentation?

(How would you like to use it / maybe integrate with sth else?)


No worries. I was just curious, having done some forum admin in the past...how you approached spam. I would guess a "getting started" doc would be the #1 priority. Especially since the server is Scala, and many may not have worked with a JVM.


Getting started, from the point of view of a site admin / moderator?

(Rather than how to install the software? For that I hope the readme file works ok.)

Hmm, you mentioned Scala and the JVM — I'm wondering if you have in mind "Getting started" with editing the source code

(I'm curious about what forum software you used in the past, as an admin, and how did you like it?)


Pretty awesome, what about APIs? Also there is a problem/bug in creating test sites. "Site name has to start with e2e-test..." but no way to enter that prefix. Might temporarily intentional


I'm making a list of API things to document right now :- )

Any special API things / features you'd be interested in? E.g. API for doing X or integrating with Y?

(I've fixed the "e2e-test-" prefix problem, will deploy in a few days. Was unintentional — I would have removed the "Create test site" link instead)


I'm in the market for something like this right now... a reddit/discourse hybrid.

Will check this out.


Then maybe you'd find this interesting: https://www.talkyard.io/-32/how-hacker-news-can-be-improved-... "How Hacker News [or Reddit] can be improved"

(If / when you find things that don't work like you want, I'd be happy for any feedback: https://www.talkyard.io/forum/ )


Re: finding new comments, I've seen another solution on one of the news site forums that I quite liked: messages are folding individually (i.e. only content is hidden but not the children), and when you enter the thread through the "new" link, only new messages are shown in an unfolded state.


It'd be interesting to have a look at that news site forum (if you have a link?).

> messages are folding individually (i.e. only content is hidden but not the children)

Seems like a nice way to give a concise overview of the discussion (who replies to who, how long each thread is). I think it'd be nice to see the first rows of each message, so one knows what it is about (maybe one has forgotten).

> only new messages are shown in an unfolded state

(So that one directly sees the messages one hasn't read before, and can start reading them effortlessly, right)

> only new messages are shown

I wonder how they determine which messages are new. Maybe it's [new since one's last visit]? Or messages one hasn't read yet? Not that easy to know which messages the visitor has read, if many messages are visible on the screen at the same time :- )


> It'd be interesting to have a look at that news site forum (if you have a link?).

I doubt that you will find it particularly useful (site in Russian, and I've no idea how reliably that feature works for unregistered users), but anyway: https://www.opennet.ru/forum/

> I wonder how they determine which messages are new. Maybe it's [new since one's last visit]?

It is. While not as powerful as status tracking for individual messages (can't skip some messages for future read as easily, can't mark message as unread etc.), it is enough for most users most of the time.


A bunch of interesting things going on at that forum, Opennet.ru/forum :- )

Nice to be able to "preview" a discussion directly on the topic list page, and interesting shortcuts the forum has:

    Открыть первые 10.  — Open the first 10. (I used Google Translate)
    Открыть последние комментарии. — View recent comments.
    Раскрыть ответы 1 уровня. — Expand Level 1 Answers.
    Линейный вид. — Linear view.
Sth like the expand-level-1-answers button is something people have suggested for Talkyard too.

> It is [...] enough for most users most of the time

Ok, thanks, interesting to know


Thanks for the links. Will dig in more.

I'm looking to build a forum/discussion for a non-technical audience with some of the policies that HN has implemented well... community will be non-monetized, but it'll be connected to a separate, sponsoring monetization channel.

I've not actually spent a lot of time on a Discourse forum, but have liked some of the plug-ins they support, and the wiki topic element, the ability to theme it, and the ability to limit or lock categories based on karma and groups. FYI on where I'm coming from.


> forum/discussion for a non-technical audience

How interesting — what would your community be about? (if I may ask)

Non-tech people is a long term goal with Talkyard.

As of now, though, I'm thinking none of Talkyard or Discourse or Flarum (did you know about Flarum? https://flarum.org) or Nodebb are particularly easy to use, for non-tech people? E.g. Markdown for formatting text, and navigating between topics and categories, feel confusing to me.

> Discourse [...] the plug-ins they support, and the wiki topic element, the ability to theme it, and the ability to limit or lock categories based on karma and groups

Some of those things, but not all, work with Talkyard: 1) Wiki topics / categories — yes, by configuring category permissions (see this reply here: https://news.ycombinator.com/item?id=22704726 ). 2) Locking categories based on groups and trust levels — yes (see the same link). 3) Plugins: No, unfortunately not. I think there'll will be a WebAssembly based plugin system in the distant future. 4) Theming: Can be done but not so easy — one needs to write CSS code. A theme & colors editor is planned.

> liked some of the plug-ins they support

I'm curious about which plugins :- )




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: