-
3 years ago
-
3 years ago
-
Checked the update, and I think there is no need to add tips on quickstart page to mention community instance. The quickstart page should be very straightforward without too much options. We have a community section on left side afterwards.
-
Hm, but that only mentions the community section, currently OneDev is advertised as "self host only". If you want it removed maybe add "Instances" option to the README.md on onedev/server.
I only realised half of the guides there when I was contributing, a lot of people aren't going to go looking, they will take one look and if it is not simple to use they will leave, the issue with user experience development 🤮
-
Hmm.. That is fine. Users seeing this tip natually thinks they can finish the quickstart tutorial on community instance. So maybe we should add a separate quickstart using community instance, and adjust some steps of the quickstart, such as user needs to register an account first, etc.
-
@robin I recommend renaming the quickstart anyways, it is quite unconventional and I did not understand what it was for before I read it. Most people call it "Getting Started" or "Introduction".
An introduction page giving people the options they have would be useful. I also would like to add to the ArchWiki giving some links to cheapish hosts which are sufficient for OneDev to allow people to know what hosts to use (maybe even use an affiliate link if a hosting provider wants to partner with OneDev, it is one of the ways some OSS projects get funding, of course this would be up to you to do if you wished, because you are the developer).
Currently I have not seen any page anywhere in the OneDev ecosystem actually explaining the choices, you got the README.md in onedev/server which is showing off the features onedev provides, but when you get to the wiki you get a quickstart guide, which speaks about docker and quickly deploying your own instance, nothing actually outlines the options you got unless you look deeper into the documentation.
-
It is very common for a project has "quick start". Searching this on google gets "58,800,000". It does not mean to set up a production instance, just give a quick demo showcase the product. So it should be as simple/quick as possible, without too much options. Just give user a feel.
For detailed info, such as machine spec, different installation flavors, there are the formal installation guide.
-
3 years ago
-
@robin Please see the latest commit, I have reshuffled the pages and added a friendly introduction page (if it is too friendly please let me know and I will tone it down a little). I have reverted the quickstart guide back to what it was before, and I have explained briefly the two options in the introduction page and linked the quickstart guide in so that users can still get started just as quickly as before.
The root url now points to the introduction instead of the quickstart guide.
-
This is much better now. For the introduction page, I'd suggest to put
host OneDev yourselfas the first option which is the primary purpose of this project, and community options not supported by me should always be used as alternative/second option. -
Also want to check do you have backup plan for your community OneDev instance? A public faced production server needs long term committment and it might cost more than a single machine... This is why I can not afford to do that right now.
-
@robin as of now, no, I doubt it will get much use in the slightest, but don't worry, if it needs to scale I will let it scale, and plus if worst comes to worst I will give long term warning before shutting it down to allow people to migrate.
My hope is for there to be a community of onedev instances so that one instance isn't drained of all their resources etc.
-
@polarian It is a really nice introduction. I like it and can feel author's kindness very much.
I also think that it will not get much attention now. But a public production instance means committment even if there is only one project. You can of course do that later when there are real projects hosted.
-
OneDev calls git to do syncing. Jgit is not used for resource intensive operations like push/pull. Let me know how to reproduce and I will check what is the problem.
-
git clone on my system normally takes about 1 minute depending on bandwidth, through onedev it took 21 minutes https://onedev.polarian.dev/onedev/server/~builds/1
-
JGit is a pure Java implementation. OneDev calls git command line directly for push/pull operations.
-
I do not have permission to see anything in the link you provided.
-
You need to configure general setting of the project to give public permissions.
-
I have fixed the permission issues with the repo, sorry new to using onedev it is very different from what I am used to... I need to find a solution to the above issue... should I branch and make a "sync" branch and in that only contain the CI/CD to sync, and then disable "main" branch from CI/CD?
-
3 years ago
-
@robin I have switched the order around like you wanted.
Anything else which you would like added or removed?
-
Perfect now. Thanks!
-
-
This idea was suggested about a month ago by me within the server repository, and I have finally decided to give it a go and see how it goes over a few months.
I have added community hosting to the community section of the wiki, and also made sure to put cautions in stating the OneDev developer(s) are not resposible for the community hosted instances. I have also added a tip at the top of Quickstart page to state that if someone does not want to run their own instance that they can pick a community instance.
The only thing I am not sure about is if you (Robin) do not want to be involved in this, how will the community section remain clean and maintained? I am happy to take it over (seen as I am the one which added it to support AUR packages etc) but if instances are permitted to be added, someone needs to investigate and test them before they are added to the list, and I doubt you want to waste your time doing that?
Any ideas about the issue above would be useful. But for now please review the commit and tell me what you think so far :)