Nieuws:

Welkom, Gast. Alsjeblieft inloggen of registreren.
Heb je de activerings-mail niet ontvangen?

Auteur Topic: Github: erg onduidelijke begin-pagina's  (gelezen 410 keer)

Offline Jenske

  • Lid
Github: erg onduidelijke begin-pagina's
« Gepost op: 2022/01/22, 16:38:31 »
Ik volgde onlangs even een link die op dit forum stond ivm Deepspeech. Als ik "deepspeech" intik op mijn zoekbalk, word ik verwezen naar een Github-pagina: https://github.com/mozilla/DeepSpeech

Als je daarop klikt, beland je op een soort technische lijst van allerlei ... euh ... programma's (vermoed ik) waar ik to-taal geen idee krijg over wat dit gaat.

Nu heb ik echter al heel vaak gemerkt dat Github en vergelijkbare sites bijzonder onduidelijk zijn: in de zoekresultaten stond bv. wél een tekst "github is ..." maar als ik dan klik op de pagina, beland ik in een soort technische oplijsting waar ik kop noch staart kan aan krijgen.

Zodus: waarom zijn sommige sites zoals Github zodanig onduidelijk gemaakt dat een geïnteresseerde als ik er echt niks mee kan aanvangen? Bestaat er zoiets als een homepagina mét indroductie die EERST uitlegt WAT deepspeech is en pas daarna een lijst geeft van de technische bestanden die erachter staan?
.. Kubuntu 23.10 op een ...
.. geen idee welk computermerk, 32 Gbyte RAM, 4 Gbyte video-RAM

Offline Pjotr

  • Lid
    • Makkelijke Linuxtips
Re: Github: erg onduidelijke begin-pagina's
« Reactie #1 Gepost op: 2022/01/22, 16:45:58 »
Kwestie van doelgroep. GitHub is überhaupt niet bedoeld voor mensen met weinig programmeertechnische kennis. GitHub is er puur en alleen voor (de samenwerking van) programmeurs. En die hebben al die uitleg niet nodig.  ;)

Offline Jenske

  • Lid
Re: Github: erg onduidelijke begin-pagina's
« Reactie #2 Gepost op: 2022/01/22, 16:57:39 »
Allez dan, ik zal me er maar bij neerleggen dat de wereld der IT niet meer aan mij besteed is .......

(terwijl ik nota bene als pionier heb gewerkt met een Commodore 64, nog heb moeten werken met Unix, met Genamap en andere GIS-systemen sinds 1986 en zelfs een beetje FORTRAN (vertelde hij zelfgenoegzaam))

(snif)
.. Kubuntu 23.10 op een ...
.. geen idee welk computermerk, 32 Gbyte RAM, 4 Gbyte video-RAM

Offline MKe

  • Lid
Re: Github: erg onduidelijke begin-pagina's
« Reactie #3 Gepost op: 2022/01/22, 17:11:24 »
Tja, ik vindt GitHub eigenlijk erg duidelijk.  :|

Re: Github: erg onduidelijke begin-pagina's
« Reactie #4 Gepost op: 2022/01/22, 17:45:23 »
Kijk bij Releases voor software tar's.
https://github.com/mozilla/DeepSpeech/releases

Bestaat er zoiets als een homepagina mét indroductie die EERST uitlegt WAT deepspeech is en pas daarna een lijst geeft van de technische bestanden die erachter staan?

Niet van alle github software. Soms staat er wel wat meer info bij github zelf.
Maar sommigen hebben naast github toch wel ergens een erg gebruiksvriendelijkere webpagina. Sommige erg gebruiksvriendelijk dat het een 'reguliere software' webpagina lijkt compleet met install bestand, uitgebreide install uitleg, screencapts en noem maar op. Bij anderen blijft het toch ook wel weer uitsluitend technisch.

Voor wat betreft deepspeech..
Meer uitleg vindt je op https://deepspeech.readthedocs.io/en/latest/BUILDING.html
Nog steeds vrij technisch in dit geval, al is het wel een stuk duidelijker dan de github page. Hopelijk behulpzaam voor jou.

En ben het met je eens. Vaak erg onduidelijk. Ik zoek dan ook altijd eerst naar de alternatieve website.
Succes!
« Laatst bewerkt op: 2022/01/22, 17:49:35 door partyrabbit »
- I ♥ Linux -
Bij irritatie, voeg hier 'partyrabbit' toe -> https://forum.ubuntu-nl.org/index.php?action=profile;area=lists;sa=ignore

Offline MKe

  • Lid
Re: Github: erg onduidelijke begin-pagina's
« Reactie #5 Gepost op: 2022/01/22, 18:08:39 »
GitHub is bedoeld om programmeurs samen and de code te laten werken. Dus niet direct bedoeld voor gewone gebruikers om software vanaf te halen of voor documentatie.  Veel applicaties hebben daarnaast nog een wiki of een documentatie pagina op ‘readthedocs’ die voor gebruikers is bedoeld.
Over het algemeen staat er vaak een link naar documentatie in de Readme file doe je onder de code ziet.

Ik heb eens samen met meerdere forum lid Just een artikel geschreven over git en GitHub. Misschien dat dat nog wel ergens op het web rond zweeft.
« Laatst bewerkt op: 2022/01/22, 18:18:26 door MKe »
Mijn blokkendoos blog: http://mke21.wordpress.com/

Offline markba

  • Lid
    • http://markbaaijens.nl/
Re: Github: erg onduidelijke begin-pagina's
« Reactie #6 Gepost op: 2022/01/22, 22:20:13 »
Zoals hierboven wordt aangegeven, github is in eerste instantie bedoeld voor opslag van code en als communicatie-hub voor ontwikkelaars. En dus niet (direct) voor eindgebruikers.

Echter, zowat ieder project beschikt over een readme waarin de bedoeling van dat project beschreven staat. Ben zelf nogal actief op github (zie mijn handtekening) en mijn streven is dat een eindgebruiker zelfstandig uit de voeten zou moeten kunnen via de readme (wordt door mij ook regelmatig getoetst).

Punt is wel, iedere eigenaar van het project is zélf verantwoordelijk voor die readme, voor de aanwezigheid daarvan en het begrijpelijkheid daarin. Soms is het project ook helemaal niet bedoeld voor een derde maar dient het puur als opslag. Het is dus zinloos om github als zodanig te verwijten dat de instructies hoe de software toe te passen onduidelijk zijn of zelfs in het geheel ontbreken.

Mocht je met een vraag zitten, dan is het handigste om via Discussion een topic te openen met je vraag; je hebt daar wel een github-account voor nodig, maar die is zo aangemaakt. Waarom op deze manier? Veelal is het email-adres onzichtbaar (= default instelling). Bovendien is het handig dat bepaalde info (jouw vraag dus) openbaar inzichtelijk is, dat kan andere gebruikers ook helpen namelijk...

Hoop dat je er iets mee kan....