Comments (6)
Technical ideas for a built-in RCOS wiki:
- Organized by topic and tags
- Sidebar of contributors to page
- Saved in database as Diffs to allow versioning
- Two database tables:
pages
: the pages their tags and whatnotrevisions
: the revisions to pages and who they were by
- Markdown support is already in
from observatory-new.
For an external wiki here is a list of possible software solutions:
https://github.com/Kickball/awesome-selfhosted#wikis
from observatory-new.
On a non-technical note - how should we incentivize experienced and senior members of the RCOS community to contribute to the wiki? Contributions for the semester could be factored into grading, for example.
from observatory-new.
@joshlebed Perhaps factor it into part of the status reports? If you're taking time to learn something write it down for others I guess.
from observatory-new.
Features necessary for any Wiki software we use:
- Obviously must be FOSS and self-hostable
- If an external database is required it must support Postgres
- Read/Write Permission controls
- Revision history
- Hierarchical navigation
Currently here are what I currently consider the best options:
- DokuWiki
- Pros: No database required, many plugins
- Cons: Ugly by default, a bit clunky to use at times, no markdown support
- WikiJS 2
- Pros: Lots of features, supports markdown
- Cons: Unfinished beta, Javascript heavy, slightly annoying UX.
- Bookstack
- Pros: Nice looking, supports markdown
- Cons: "book/shelf" model is confusing
Of these three I think DokuWiki would be the best choice for now, and likely the easiest to migrate away from if we change our mind.
However, depending on the development status of WikiJS 2 I would chose that instead.
from observatory-new.
We went with Dokuwiki. Not sure why this is still open actually.
from observatory-new.
Related Issues (20)
- Container Crashes on Restart
- Audit Logging HOT 3
- Attendance Improvements HOT 1
- Visual improvements HOT 1
- Mentor's cannot create small group codes HOT 2
- Delete Project is not deleting the project HOT 1
- User and dashboard pages fail to load after creating project. HOT 4
- Attendance Code not case sensitive HOT 1
- Calendar should show meeting times for groups
- Show project commits on Projects page
- Improved Accessibility
- Add Minor help text to forms HOT 1
- String Input is not limited HOT 1
- Stress test and Performance Benchmarks
- Mongo DB Database Importer HOT 1
- User delete handler does not delete user relation to projects
- Audit Log Viewer
- Message for Entered Attendance Code
- Add Achievements
- CSV Export
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from observatory-new.