Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Library Status? #264

Open
machineghost opened this issue Oct 27, 2019 · 8 comments
Open

Library Status? #264

machineghost opened this issue Oct 27, 2019 · 8 comments

Comments

@machineghost
Copy link

machineghost commented Oct 27, 2019 •
edited
Loading

I'm looking for a JS-based wiki, and Jingo seems promising, but it hasn't had any commits made in ten months. Clearly it's not "done" yet (as it has 55 issues), so my question is: how come?

Has the maintainer lost interest in the project, or is there some other reason? And if they lost interest, was it because of core issues with the library, or because they found a better solution, or because the library is "good enough" for them, or ...?

It just would be helpful to understand why a seemingly great library with almost 1k stars has had no activity for such a long time.
@claudioc
Copy link
Owner

claudioc commented Nov 15, 2019 •
edited
Loading

Hey @machineghost

thanks for the questions (I should consider adding the answers to the README at this point).

I am the only developer of Jingo and as you can see it is quite an old project. A lot of people have it installed (I don't have the numbers of course, but over the years I got a lot of feedback and almost 1k stars here in github) which means that I consider it definitely "done", at least as its version "1". The open issues are mostly "wontfix" or integrations that I cannot consider be part of the core system... I leave some of the issues open because sometimes people find a solution to a specific problem other users may have... it's kind of a "public forum" for Jingo...

I keep updating Jingo for bugs and security issues (I am about to release an update just now).

Features wise, I am not actively developing it because:

  • I have now less time than I had before, when I started it
  • a couple of years ago I started developing the second version of the wiki engine which means that all the development efforts are of course focused on that version, not this one
  • to be honest, since Jingo is a pet project and should be fun to work with, the codebase is pretty old, which means that working with it is not fun; the new version is much better in this regard

The problem with Jingo 2 (source code available https://github.com/claudioc/jingo-2/ ) is that the list of (new) features is quite big and being a single person with a big project to handle is not easy, if you want to release something useful, secure, maintainable and well documented (all MUST HAVEs for Jingo 2).

That's the status of things right now :)

@machineghost
Copy link
Author

machineghost commented Nov 15, 2019 via email

@tiger73
Copy link

tiger73 commented Nov 28, 2019

Hello -

I just installed Jingo 1.9.4 and was going to make some queries when I stumbled across this post and am of course intrigued. Thank you very much for Jingo 1.x!!! I selected Jingo because this was exactly what I was looking for - LIGHT, online editing & preview, git mgmt (I have an internal git repo) as this will be a small wiki.

Is the current jingo-2 @ bitbucket stable enough for light use and these light requirements? Can I install jingo-2 and point it to the current jingo-repository?

Thank you very much for your consideration and continue investment in Jingo!

-t

@claudioc
Copy link
Owner

@tiger73 you can try! A couple of days ago I released some important changes in Jingo2 that should make it usable "enough". Please keep in mind that:

  • that version is currently totally unsupported. If it works, good but if it doesn't… sorry :)
  • it's in active development, which means that if I want to break something or change the look or some configuration keys or values I want to be able to do it without thinking of the installed base (like I do for Jingo 1, of course)
  • it's not packaged, which means that you have to install it yourself

I wouldn't consider it ready for its prime time, unless you ALSO want to contribute to its development :)

@tiger73
Copy link

tiger73 commented Nov 28, 2019 via email

@leviwheatcroft
Copy link

@claudioc I'm really interested in helping out with jingo-2

I had a look at the repo you shared and managed to get it to run!

Absolutely not a criticism at all, but just to mention a few things I needed to do:

  • install es6-promise and @types/passport
  • create config.json from src/config/defaults.json (not necessary ?)
  • copy templates from src/routes to dist/routes

You should absolutely make a github repo for jingo-2. It looks like you're not far off from a somewhat-working-alpha, I'd be happy to help you work towards that and build a docker container.

Once we achieved that you might get some love from other contributors. I do think there's a niche for a nodejs git backed wiki, and jingo is the best in that category for the moment.

@claudioc
Copy link
Owner

Hey @leviwheatcroft ,

Damn right, sorry... es6-promise is needed and I forgot to add it :/

Yes, the config must be created manually and you can use (as for Jingo-1), ./jingo -s

I am going to fix those things and move the repo to github today! (I will keep you updated).

Thanks!

@claudioc
Copy link
Owner

@lewiswalsh All done (https://github.com/claudioc/jingo-2

I don't get the issue you have with the templates though?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@claudioc @machineghost @leviwheatcroft @tiger73