Hi everyone! I'm new here, please be nice :)
I'm trying out the various services that sourcehut has to offer, and I
think I'll move some of my code here, but one of the things I have
trouble with is actually getting an idea of what the service will do and
how it will work. I've seen a couple of pages on the man site, which
help to explain mailing list etiquette and some available features, but
what it's really missing is links to or screenshots of sample pages.
For example, I have no idea what the todo service would look like in
practise, so I've been a little hesitant to set one up. By guessing
URLs, I managed to find this page[1] which immediately makes me very
happy. I like the interface and I can see how discussions work and I'm
now a lot more comfortable if I wanted to set up a todo myself.
[1] https://todo.sr.ht/~sircmpwn/todo.sr.ht
I think sourcehut would greatly benefit if the man site had links to
real-world uses for the services so that people evaluating sourcehut can
see all of its services in action and properly understand them.
For the same reasons, it would be good if on the landing page for a
service there was a way to see a list of things that are actually using
that service, either a curated list, or most popular, or most
updated. The main site landing page has a "discover projects on
sourcehut" link, which is good, but there should be a button like that
for all the services.
- Cadence
Hi Cadence!
> I think sourcehut would greatly benefit if the man site had links to> real-world uses for the services
I agree that having links to real world uses would be a nice addition to
the manual.
Every wiki on sourcehut is a git repository. At the bottom of every
page, you have the repo URL and the information about the last commit
made on the repo (not specifically the page you're viewing).
You can then clone it, make the changes you'd like to see applied and
send them upstream so that Drew can review and incorporate them :)
You can find some help here[1] and here[2] about how to propose changes
on sourcehut.
[1]: https://man.sr.ht/git.sr.ht/send-email.md
[2]: https://git-send-email.io/> For the same reasons, it would be good if on the landing page for a> service there was a way to see a list of things that are actually using> that service, either a curated list, or most popular, or most> updated.
On the project hub[1] you can click "Discover projects". Since projects
are groups of source + issue tracker + mailing lists, you can discover
how these services are used.
[1]: https://sr.ht
I don't think that making git repos, mailing lists or issue trackers
more discoverable by themselves would be useful. IMO it would be best to
discover the related project on the hub and improve the UI to let users
move between services of a same project.
E.g. if you're on the issue tracker for todo.sr.ht, you should have a
quick access to the source code and the mailing lists. This is currently
not implemented but I believe it's being worked on.
--
Gabriel Augendre
Trying to figure out how to post a public reply. Hopefully I got it
right this time.
> You can then clone it, make the changes you'd like to see applied and> send them upstream so that Drew can review and incorporate them :)
Sure, I'll give it a ago!
> You can find some help here[1] and here[2] about how to propose changes> on sourcehut.> > [1]: https://man.sr.ht/git.sr.ht/send-email.md> [2]: https://git-send-email.io/
Thanks, I just practised using these and I think I'm comfortable
enough to try them for real now :)
> On the project hub[1] you can click "Discover projects". Since> projects are groups of source + issue tracker + mailing lists, you> can discover how these services are used.
It's true, but if I'm looking for examples of the todo service
specifically (which I am!) then it's not very useful to indicate
projects that may or may not actually have a todo associated with
them.
- Cadence
Hmm, I made my commit, but it seems I can't push to the wiki
directly. I read the documentation[1], which says:
> Publishing your changes is as easy as committing them and pushing> them upstream.
[1] https://man.sr.ht/man.sr.ht/#publishing-your-changes
Git says "Access denied."
I'm trying to edit this page: https://man.sr.ht/todo.sr.ht/
Do you know if there's a mailing list that I need to send my commit to?
I can't seem to find one.
- Cadence