ROADMAP: v0.19

[ryanlelek]

Why Am I Being Notified? Unsubscribe!

You were tagged because you submitted an issue in the past for Raneto.
This is mostly for documentation reasons as we sort through the repo.
Join the discussion or Unsubscribe by clicking the "Unsubscribe" button in the right sidebar =>

Goals

Here's a summary of where the project is heading based on the submitted issues.
Version 0.19 will have multiple changes and get us on the path for Version 1.0.

Have questions or a suggestion? Comment below.
This post will be updated accordingly and kept current based on the discussion.

Also, if you have a better way to plan and collaborate on these roadmaps, please share.
(GitHub Projects?)

---

Must Haves

Mailing List

Email list to send only announcements on releases, security, etc.
Pending. Open to suggestions on software.

Documentation Update

See #373

Extended Testing

Expand the test suite and further break down code into smaller components

Extract example/ directory to another repo

Reporter(s) @dkebler @jrichardsz
The current example/ directory has references to this repository as its parent.
This is confusing new and existing users.
We should have a separate repository for the example and not mix the two
Related:

• Error: Whoops. Looks like this page doesn't exist. #296
• What if I want to use as library instead run the entire source code? #330

Upgrade to Bootstrap v5.x

Reporter(s) @ryanlelek @GrahamDumpleton
Upgrade to keep current with the module and design trends
Related:

• Use of glyphicon no longer in bootstrap 4. #287
• https://getbootstrap.com/docs/5.2/migration/
• Remove npm module bootstrap-rtl
  --- Related: Support non-latin characters (i.e Arabic) #244

Deployment Options

Reporter(s) @will-code-for-pizza @ryanlelek

• Heroku
• DigitalOcean
• Docker (of some variety)
  --- @prologic @madhuakula
  --- Update README with Docker deployment instructions #125
  --- https://github.com/appsecco/raneto-docker
• Generic VPS with Ansible (EC2, DigitalOcean, Linode, Vultr -- Debian only)
• Generic VPS with Docker / Docker Compose
• Synology NAS (probably via Docker)
  --- Raneto fails to start on Synology NAS / node 0.10 #282
• QNAP NAS (probably via Docker)
  ... what else would you like? TrueNAS, AppFog, Netlify, Vercel, Railway, etc

Static files in content/

Reporter(s) @chenfengrugao @zazaji
Raneto users want to upload static assets like images, and there is not a good way to do that currently.
The content/ directory contains only Markdown files.
We want to allow a way to serve static files as well.
Related:

• upload local image #300
• How to show the png images in the page? #359
• Allow Images in Content Directory #372

Extensive Testing of Reverse Proxy

Reporter(s) @djhworld @AnkushLambdatest
Reverse Proxies like HAProxy, Nginx, Caddy, etc are more common today.
Raneto should fully support a base uri, path prefixes, and IP-passthrough (X-Forwarded-For and proxy-protocol-v2)
Related:

• Edit page link not working behind reverse proxy #310

Translation Fixes

Reporter(s) @jci
Current: Some translation snippets are not being used correctly. The whole repo needs to be double-checked for usage. Examples "Login Button" and "Password" on Login page
Desired: Translations should apply to common user interface elements
Related:

• Translation ignored #257

Remove Extra Dependencies

• pm2

---

Nice to Haves

Pending - Let's Encrypt Automation

This can get sticky based on where things are deployed. Marking as it's an important feature in 2022

Allow redirects per-page or path prefix

Reporter(s) @ArtFlag
As documents change, it may be needed to redirect a page to a new page.
We can handle this on a per-page basis with metadata or on a path prefix level
Related

• Easy way to set up permanent redirects to a new url? #349

Fine-Grained Permissions

Reporter(s) @mtaobiz @cosmosresident @fbo @BenGoodmanUK @DoctorRiceYouSee
Current: Viewing is public, editing is admin/login. Viewing can also require login.
Desired: Fine-grained role permissions that can be granted to users. "guest" for not logged in, etc. This will allow certain pages or categories to be blocked.
Related:

• Access to page via login/pass  #112
• Permissions via Logins #168
• Separate Google Authentications for Viewing/Editing #334

LaTeX and Scientific Support

Reporter(s) @theinexplicablefuzz [unknown ghost acct] @kongxiangyan
Support advanced writing notations LaTeX and scientific (Mathjax, etc) to make it easier to express math equations, scientific topics, etc.
Related:

• add support for mathjax within markdown files  #172
• markdown & Latex #283

Long Shot

Adding these for discussion but will likely only be part of a future release

Automated Backup

The reason this is needed is because editing can take place on the server.
Send content/ on a schedule to a remote server of some kind.
Destination: Current Suggestion - Send tar file to S3-compatible storage

Shared Content

Reporter(s) @jmgilman
Raneto probably wont need to be super-scalable for concurrent users but for high-availability reasons, two or more machines may need to share Raneto content files.
Syncing doesn't make sense for 3+ machines, so having a shared SMB/NFS backend may be desired. Or pulling from S3-compatible storage and caching.
Related:

• Sync with remote host #160

Static Files

Current: Markdown files are rendered on page request. This increases machine work with every request and can also introduce security issues.
Desired: On edit or creation, render markdown to static files. Then display and search the static files to visitors

[eHonnef]

Hello,

Any plans to include OpenID connect integration? So I can use my keycloak server for authentication.

Thanks :)

[ryanlelek]

Hi @eHonnef ,
No current plans for OpenID and the backlog is already pretty large so no ETA on when it would be available.
We currently have normal user/pass and Google Sign In but I understand if you don't want to use those.
If you're interested in working on a PR, we'll do our best to guide