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.

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

[doc] enable wiki #344

Open
Freed-Wu opened this issue Jun 20, 2023 · 14 comments
Open

[doc] enable wiki #344

Freed-Wu opened this issue Jun 20, 2023 · 14 comments

Comments

@Freed-Wu
Copy link

Enable wiki: https://docs.github.com/en/communities/documenting-your-project-with-wikis/about-wikis and https://docs.github.com/en/communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis

It allows user to add their projects based to pygls to the wiki easier than changing https://github.com/openlawlibrary/pygls/blob/master/Implementations.md.

@tombh
Copy link
Collaborator

tombh commented Jun 20, 2023

I'm personally not a fan of Github Wikis, I find they too often go out of date. But I'm open to it nevertheless.

I actually have thought a few times that the community implementations list should be in the README (albeit right at the bottom). It's a great selling point for people to see as soon land on our "homepage".

Do you have an implementation you'd like to add?

@Freed-Wu
Copy link
Author

Freed-Wu commented Jun 20, 2023

@Freed-Wu
Copy link
Author

Freed-Wu commented Jun 20, 2023

Because there are too many language servers which need to be added, add them is very frequent, so I support to enable wiki to make it easier 😄

@Freed-Wu
Copy link
Author

Freed-Wu commented Jun 21, 2023

Or provide an organization like sphinx-contrib to collect all language servers based on pygls? @tombh

@tombh
Copy link
Collaborator

tombh commented Jun 23, 2023

OMG I love your servers!! They're such great uses of Pygls. Pygls isn't just for big serious language servers, it's also hopefully designed in such a way that just like you've demonstrated you can use to make smaller, more focussed language servers.

I personally think yours (especially yours!) and our existing list should all be on the README. Not only do they demonstrate Pygls' popularity, but they're documental in that they document intended usage of the library. We don't have to have the gnarly table like we have in https://github.com/openlawlibrary/pygls/blob/master/Implementations.md, we can just make a list like you have above.

@Freed-Wu
Copy link
Author

I project to create more language servers. Can any organization like sphinx-contrib for sphinx extensions, zsh-user for zsh plugins be provided to contain them? It can make more people to find them easier.

@tombh
Copy link
Collaborator

tombh commented Jun 26, 2023

I'd never thought of this. And so thinking about it for the first time, and knowing that at least you want to contribute your servers to a dedicated pygls-contrib org, makes me think it's a good idea. We're actually in the process of making a pygls-org org, do when we publicise that, I'll bring up the idea formally.

But basically, yeah, I think it's a good idea.

@Freed-Wu
Copy link
Author

makes me think it's a good idea. We're actually in the process of making

Great. I wait your publicizing 😄

@Freed-Wu
Copy link
Author

Hey, what is the progress of pygls organization? I am creating a language server to display the translated result of the word of current cursor and complete the words in translate history 😄

@tombh
Copy link
Collaborator

tombh commented Jul 1, 2023

Awesome!

I think it'll be a month at the soonest before we get that Pygls org setup.

@Freed-Wu
Copy link
Author

it'll be a month

New month is coming 😄 Any progress about it?

@tombh
Copy link
Collaborator

tombh commented Aug 7, 2023

You're right, we're still talking about this, sorry 😬

@Freed-Wu
Copy link
Author

New month is coming 😄 Can I know what is the obstruct? Is it that the name of organization is hard to determine? Or should the organization be in github or gitlab? Or how to manage the organization? I think there are many organizations can be referred like gnu-octave or sphinx-contrib.

@tombh
Copy link
Collaborator

tombh commented Sep 1, 2023

It's more to do with how much responsibility we want to take for the code contained in such an org. Are we prepared to formally approve of the code as if it were our own. If people trust Pygls then should they equally trust the pygls-contrib org?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants