Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
  • 13:22
    j-f1 synchronize #1172
  • 13:21

    j-f1 on master

    Searching for maintainers Update README.md Merge pull request #1285 from b… (compare)

  • 13:21
    j-f1 closed #1285
  • 12:22
    baelter synchronize #1285
  • Oct 22 08:14
    luyinhua commented #1283
  • Oct 22 05:00
    ocavue commented #1286
  • Oct 22 04:43
    ocavue opened #1286
  • Oct 22 03:48
    gengjiawen commented #1258
  • Oct 21 15:06
    baelter opened #1285
  • Oct 21 08:27
    HUANGWEIWEIWEI commented #1283
  • Oct 21 03:03
    luyinhua commented #1283
  • Oct 20 09:57
    davidsneighbour commented #1283
  • Oct 20 03:03
    xavieryao commented #1241
  • Oct 20 03:00
    devdocs-bot closed #1276
  • Oct 20 03:00
    devdocs-bot commented #1276
  • Oct 20 03:00
    devdocs-bot opened #1284
  • Oct 19 21:50
    RandellDawson commented #1283
  • Oct 19 21:47
    lommaj commented #1283
  • Oct 19 21:45
    lommaj commented #1283
  • Oct 19 21:44
    lommaj commented #1283
Thibaut Courouble
@Thibaut
@baelter I donated DevDocs to freeCodeCamp to help spur a community of maintainers. Unfortunately that hasn't happened to the extent we were hoping, but if you or anyone else is interested in working on DevDocs I'm sure Quincy & team can set you up :)
I'm at a stage of my life where I don't have the time/energy/will to maintain DevDocs as I used to, but am always happy to answer questions and do code reviews, especially if it helps new maintainers ramp up.
Starbeamrainbowlabs
@sbrl
Ah, I see. Thanks for the reply @Thibaut! I was just wondering if there was a way to request that a scraper to be kicked off again in whatever backend it is that powers devdocs.io is all - is there anyway to get in touch with Quincy (I assume they are responsible for this)?
Sadly I do not know Ruby / have a Ruby dev environment, otherwise I would have contributed a scraper or two before :P
Is there support for scrapers in other languages at all?
Joel Burton
@wjoelburton_twitter
Hi, all. I'm partially through writing a new scraper/filter for Flask, but have a stumbling block.
The only part of Flask's docs that are a good fit for DevDocs is their API page. I've got my scraper just reading that page and feeding it into my filter successfully.
However, it creates one high-level entry for everything; I'd like to break that up by classes.
If there's a pointer to a docset like this, I can dig into that.
Starbeamrainbowlabs
@sbrl
I think that Node.js might do something similar @wjoelburton_twitter
Joel Burton
@wjoelburton_twitter
Thanks, @sbrl, I'll take a look there.
Starbeamrainbowlabs
@sbrl
np
not a devdocs dev / contributor myself (don't know Ruby), but am happy to help :-)
Shadowplays4K
@Shadowplays4k
does the devdocs have an api where I can search for stuff?
Anders Bälter
@baelter
@QuincyLarson @Thibaut I'd be happy to help out, at least with keeping some languages up to date with new versions.
Starbeamrainbowlabs
@sbrl
Just a user here, but that would be awesome! I've been noticing that they've been getting out of date @baelter
Gergely Gombos
@gombosg

Hi all, yes, DevDocs is kind of dying at the moment... lots of issues, stale PRs, no commits since months.... I hope it can still be saved, because it's been my favorite docs browser for years and there's really no alternative to it.

@Thibaut , we understand that you don't have the time to maintain this project, but what is your vision for its future?
How would it be possible to onboard maintainers/contributors?
What I imagine as goals:

  • keep the builds running!
  • merging doc update PRs, reviewing, keeping code quality up
  • triaging issues
  • if possible, fixing some critical bugs

-> for all this, probably no extensive Ruby knowledge is needed. It would be enough to leave the project in a maintenance state.

As I see from the count of PRs, the community is here to help.

What would be the way to move forward?

Senya
@cmrd-senya
Hello! I've opened this little PR with a change for the Gemfile today: freeCodeCamp/devdocs#1271
Its main purpose to fix the issue that is blocking devdocs to be run as a systemd service.
Would be great if someone could take a look
Starbeamrainbowlabs
@sbrl
Might be worth sending an email, @gombosg. Maybe use the git commit history and cc in a bunch of recent contributors?
If that doesn't work, I'm afraid it might be time for a fork.
I don't know Ruby at all, but I'd be happy to help out with reviewing, triaging issues etc
Thibaut Courouble
@Thibaut

@sbrl @baelter @gombosg if you're able to rally a small team behind maintaining DevDocs over the long haul, feel free to email me at thibaut@me.com and I'll be happy to help set this up with Quincy + share context on an ongoing basis.

In the past whenever we've had a single active maintainer it has proven impossible to sustain over time and we end up burning that person out. I think for DevDocs to thrive we need a team, but to this day we haven't been able to find enough maintainers to form one.

Unlike most other open source projects, it's a big time commitment to maintain DevDocs and the work is quite repetitive. On the flip side, DevDocs is still very popular and helping out many thousands of developers. I'd love to see it thrive.

Jasper van Merle
@jmerle
I can confirm the time commitment and the repetitiveness of the work (I guess I was that single active maintainer once) and can definitely recommend getting at least 2 people together so you can divide the workload a bit (and to have someone to review your own PR's)
Starbeamrainbowlabs
@sbrl
Perhaps an advertisement for more maintainers in the README would help here, with a direction to this Gitter?
I'd perhaps say a team of 3-5 at least would be ideal
I don't have the xp with Ruby to assist with the code, which is my main concern
Thibaut Courouble
@Thibaut
I can merge PRs to the README if you or some else wants to organize the search for maintainers (just @mention me on the PR)
Jed Fox
@j-f1
I think the reason I burned out was a combination of not enough free time left after schoolwork and the backlog of PRs and updates that resulted in. I’d be happy to collaborate with other folks — maybe we could each pick a subset of the docs to maintain?
Jed Fox
@j-f1
It would also be great to figure out a way to automatically update the docs — @jmerle’s bot is a great start but it would be great if it could act on the updates and only open an issue if it detects a problem with the update. I could also add a link to report issues with the docs to each page so the burden of checking for errors resulting from changes in the sites we scrape rests a little more on the users (who know the docs they’re reading pretty well).
Senya
@cmrd-senya
IMO it really helps when you work as a team rather than maintaining a project alone. This way you can motivate each other and also you don't feel pressured because you know that someone else can help whenever you need a break. I think it can really help to avoid burn out if there are 3-4 people who share the maintenance work.
Michael Skorokhodov
@Samsuper_gitlab
Hello! When will the information about C ++ be updated? I mean C++ 20. Or should I start adding information myself?
Starbeamrainbowlabs
@sbrl
@Samsuper_gitlab Devdocs scrapes from websites. It's probable that the scraper hasn't been run in a while. See the conversation above for that.
Pavel
@yekm
docs from man pages section 2?
Starbeamrainbowlabs
@sbrl
@yekm As far as I know DevDocs doesn't scrape man pages. I don't know of another project that does that, but it must exist.
Pavel
@yekm
cant find it
Adding all of them to DevDocs would make the search unusable
it will be slow or it is just a matter of too many seemingly useless results in the seach results
?
Starbeamrainbowlabs
@sbrl
I'm not sure. I'd assume they mean that the search would be too slow
Jasper van Merle
@jmerle
I know that there is a man docset for Dash (and therefore for Zeal and Velocity as well) at https://github.com/Yanpas/mandocset
Pavel
@yekm
thats just html generation. it is easy. i saw 13 steps in adding-docs.md and i am starting to doubt the whole idea of adding man pages to devdocs, especially if perfomance imact will be noticeable.
HARI VARDANACHARI KORRAPATI
@chari1239
Hi all
I'm setting up the devdocs locally for the first time
Downloading docs via "bundle exec thor docs:download --default" fails for all 6. For example, "(1/6) DOM Events FAILED (Errno::ENOENT: No such file or directory - gunzip)
Can anyone help me on this to resolve?
Sam
@samfundev
@chari1239 I wasn't able to figure out what was wrong but maybe this would be a good starting point: April 27, 2020 8:36 PM
HARI VARDANACHARI KORRAPATI
@chari1239
Hi @samfundev , I was able to resolve. With my analysis, this error mostly happens in windows machine.
  1. gunzip is not available, have to install it.(make sure gunzip cmd works rather gzip)
  2. by default tar cmd will use git's tar path which will give error : "C: cannot find path error", add System32/tar.exe path to your ENV PATH variable
that link will help
HARI VARDANACHARI KORRAPATI
@chari1239
Hi @all , I want to work on the following issue
add the new version of pandas, I'm trying to understand the code. If anyone has any idea, who can walk me through what needs to be done, that will be helpful
Kenneth-Fries
@Kenneth-Fries
Any prospects for adding LISP? Devdocs has become my favorite goto for documentation, and now that I have to learn LISP, I see there is a dearth of information on the internet. It all seems disorganized and not laid out well. Wish I knew it well enough to contribute.
Starbeamrainbowlabs
@sbrl
@Kenneth-Fries you probably want this trello board for that : https://trello.com/b/6BmTulfx/devdocs-documentation