[TYPO3-doc] Integrating "Disqus" on docs.typo3.org

[Bastian Waidelich]

Bastian Waidelich wrote:

Oops there went my message.. and I even cross-posted it *sry*

> After a fruitful discussion

..a fruitful discussion I agree that using 3rd party tools has some 
severe drawbacks (lack of control, lack of privacy).

So I came back to the initial idea of creating a Flow based service for 
the comments for following reasons:

* We have a package TYPO3.Comments that could be used for a base
* It would be a good example for a Flow based service that is used by 
the TYPO3 community
* It could serve as documentation on how to create a REST API with Flow

After doing a couple of tests, I think the implementation is not as 
complex as I thought initially (apart from some hurdles, see below). In 
regards to the minimal feature set:

* Proper spam protection

The commenting should be restricted to users with TYPO3 accounts.
Further filtering could be done with akismet if needed.

* Flagging of inappropriate comments

Should be very easy to do

* Voting (so helpful comments can be displayed on top)

That's a bit more complex. Especially in regards to the ordering of 
nested comments.

* Syntax highlighting for various languages

Easily possible with HTMLPurifier & highlight.js or similar.

* Notification-system

Should be possible out of the box with Commands & cron jobs. If traffic 
gets too high, this could be replaced by a proper job queue.



I created a little prototype that already works quite nicely.
In contrast to disqus I'd suggest to use a single dimension for the main 
posts (rather than a nested tree) with the possibility to comment a post 
(similar to stackexchange.com).
I got a tree based approach to work, but that gets very complex when 
ordering after votes and I think it wouldn't be very constructive either.


The main unknown I currently face is authentication and I'm currently 
waiting for a reply from Stucki, Robert and/or Christopher regarding the 
SSO implementation mentioned on August 21st.

Best,

-- 
Bastian Waidelich
--
Core Developer Team

TYPO3 .... inspiring people to share!
Get involved: typo3.org