Docuss: an experiment on how to embed discussions in web pages

certainly an interesting approach. doesn’t seem to be set up to work on a mobile site yet. i guess the discussion topic would need to appear on the bottom half of the page.

can this be automated to create a new forum topic each time a blog post or event is created in a cms? or does code need to be dropped in each time?

oh, also the balloons didn’t appear in Brave browser, i had to open it in Chrome to find them

also;

  • is this intended to sync with existing forums or would users need to create a new forum especially for each site it’s added to?

  • how do you add the balloon’s into the areas you want them. viewing your source code i couldn’t see anything dropped in to call them to the point you wanted them. Are they set to appear on every paragraph?

  • what license are you thinking of releasing it under?

@AndyatFocallocal, thanks for your comments and questions.

doesn’t seem to be set up to work on a mobile site yet.

Nope, you’re right.

can this be automated to create a new forum topic each time a blog post or event is created in a cms? or does code need to be dropped in each time?

The current prototype needs additional code in each new page added to the system. Such code could be part of the “blog post” template within the CMS. However, I’m currently working on a new version where target pages don’t need to contain additional code.

the balloons didn’t appear in Brave browser,

Good catch, I’ll have a look.

is this intended to sync with existing forums or would users need to create a new forum especially for each site it’s added to?

One forum can support multiple web sites (see my demos: all demo pages use the same Discourse forum).

how do you add the balloon’s into the areas you want them. viewing your source code i couldn’t see anything dropped in to call them to the point you wanted them. Are they set to appear on every paragraph?

In the demos, I add balloons to every header. But this should be up to the user.

what license are you thinking of releasing it under?

I didn’t think about that yet. I’m still trying to figure out what to do exactly with this experiment.

If you wanted to implement it into a live site to have users and other devs help develop/review it, i’m part of a community of volunteers creating projects to build a world with more peace and well-being in it. Here’s one of our projects aimed and transforming homelessness through community connection, it’s launching next month: https://brightertomorrowmap.com

You’d be welcome to join in the build and add Docuss to create a comments section and give it a test run, I’m not a big fan of the other options we’ve found so far which is why i created that post to try and find people to build a new plugin

@AndyatFocallocal, I will think about it. Would you please PM me some URLs where you would like a comments section? Thanks.

sure, click any of the icons on the map for our homelessness project, the forum would be at the bottom of the page to give users a place to communicate with the person who posted it, and other users who know about that resource we’ve also just had a high level app developer join in and i was thinking of challenging them to integrate the forum more central to the user experience to increase collaboration. i imagine that would be something akin to a slide open user profile widget with the forum, their stats from the forum, and Trello (which we use for project management). I haven’t yet proposed it, but if you both liked it that would bring an app specialist in to look at Docuss’s mobile integration.

@syl i guess with your system we could create a tag at the bottom of each page when creating an event/page, which Docuss would respond to and create a forum thread.

The new Docuss prototype can be found at www.docuss.org

You can now add discussions to existing web pages by creating a Docuss Link.

A Docuss Link is a short URL pointing to the target page and adding the discussions dynamically.

2 Likes

Really interesting! This could be even cooler if it can be used with media content whether it be pics, gifs or video

@subtenko: although I didn’t try, I think you can attach Docuss balloons to media content (in order, for example, to comment images).

Announcement: Docuss will be down today and tomorrow (Oct. 7-8) for maintenance.

How is this different from https://hypothes.is/?

Answered above:

2 Likes

Did you yet? :smiley:

I’d be thrilled to try it out anyway, but I can’t access the login page (500 error).

Sorry @_vincent, the login issue should now be solved.

During the past month, I’ve worked with my two first “customers”, and the fact is they don’t use Docuss the way I had in mind initially. I identified two use cases:

  1. People who want to massively work on documents. This is the showcase I’ve put on www.docuss.org.
  2. People who want to integrate their own Discourse forum with their own web site, so that parts of their site are “connected” to specific Discourse tags (think a “Discuss this page” link opening a side panel).

I’ve decided to provide “use case 2” under an open source license. I’m still thinking about “use case 1”, which is a more technical offering and more complex to deliver to users (as it contains a code injection proxy).

Also, still looking for developers to join :slight_smile:

3 Likes

I can confirm, I’ve been working with @syl on our site and it is beginning to provide a very flexible and useful ecosystem.

1 Like

Kein Operationsplan reicht mit einiger Sicherheit über das erste Zusammentreffen mit der feindlichen Hauptmacht hinaus.

4 Likes

Can I suggest a 3rd use case?

I have been pondering how to embed Discourse at the bottom of a blog or web page. As you know, standard Discourse cannot be embedded in an iFrame - apparently you resolved the cross-domain scripting concerns. The official technique to embed with Javascript requires navigating back to the Forum in order to add a comment, and though I understand why that is done I think a simpler solution would be nice.

So my question is - could you side by side design be the solution to the “embed Discourse” issue? I would suggest not having discussions on a paragraph level with the orange balloon (which would probably result in very few active discussions) but rather a plugin so a Discourse discussion is linked at the URL level with a web page. So a user would view a URL in his browser and a corresponding DIscourse discussion of that URL would appear. Presumably the admin could choose to restrict which URLs can be discussed a forum by either whitelist or blacklist or could allow discussion of any URL.

Thoughts?

@rkaplan: yes, the side-by-side design could work on a per-url basis. Feel free to contact me privately if you want to discuss your actual use case.

Notice that the orange balloons are not always used to comment paragraphs. They can actually serve as toggle switches (in which case their graphical representation should probably be changed). See this example.

Additionnaly, the orange balloons provide a selection mechanism, so that users know that, if something is selected on the left (usually in yellow in my demos), then the corresponding topics are shown on the right.
If you remove the selection mechanism - as you seem to suggest -, some design questions need to be discussed. For example, if each url on the left corresponds to a dedicated topic list on the right, how do users ever access the Discourse home page? (the one containing the latest topics, for all urls) And how do they quit the Discourse home page and come back to the specific topic list of the current url?

Thanks @syl - I will send a PM with follow-up details