[QGIS-Developer] A nice task for a community member: revamping the QGIS github landing page

[Nyall Dawson]

Hi all!

If someone's been looking for a great introductory task to start
contributing to QGIS, I'd like to put a call out for a volunteer to
have a go at re-working the landing page (the README) that you see
when you visit

https://github.com/qgis/QGIS

While the current text is all accurate, it's very dry and technical,
hasn't had a major update in years, and doesn't really paint QGIS in
an "exciting" light! I'd love to see this revamped into something more
visual which really showcases QGIS' capabilities. I'm thinking
something more like what you see for the alternative QGIS albireo
frontend at https://github.com/kadas-albireo/kadas-albireo2...

It'd be a great task for someone who is well familiar with QGIS'
capabilities and has a good English writing style, and it doesn't
require any technical capabilities between simple markdown editing.

Thanks in advance!
Nyall
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Pedro Venâncio-2]

I agree with Nyall.

I think WebODM landing page is also a great source of inspiration:

https://github.com/OpenDroneMap/WebODM

Best regards,

Pedro

Nyall Dawson <[hidden email]> escreveu no dia quinta, 11/02/2021 à(s) 22:11:

Hi all!

If someone's been looking for a great introductory task to start
contributing to QGIS, I'd like to put a call out for a volunteer to
have a go at re-working the landing page (the README) that you see
when you visit

https://github.com/qgis/QGIS

While the current text is all accurate, it's very dry and technical,
hasn't had a major update in years, and doesn't really paint QGIS in
an "exciting" light! I'd love to see this revamped into something more
visual which really showcases QGIS' capabilities. I'm thinking
something more like what you see for the alternative QGIS albireo
frontend at https://github.com/kadas-albireo/kadas-albireo2...

It'd be a great task for someone who is well familiar with QGIS'
capabilities and has a good English writing style, and it doesn't
require any technical capabilities between simple markdown editing.

Thanks in advance!
Nyall
_______________________________________________
Qgis-user mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-user
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-user

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Martin Pergler]

Happy to take this on (next week, this week is a bit crazy).
I like all 3 examples given: key thing being leading off much more with an
easy-to-understand, illustrated list of main functionality and use cases.

By way of introduction, 30 years ago I was a software developer, back when
Pascal and C (++ was cutting edge!) were mainstream and Prolog was sexy (at
least for geeks, that is). I then became a mathematician for a while, before
going into business consulting. I've done a fair amount of technical writing
and ran an editorial board for a while. My day job is now risk consulting,
including probabilistic modeling, Excel/VBA, and R. On the side I help
manage and preserve a decent chunk of Canadian wilderness, through which in
the past couple of years I've become more and more involved in GIS. First,
just making a map of the darned thing, but more recently vegetation and
land-use analysis, indexing of research notes and wildlife photos,
automation so others can use it, and even more recently UAV 2.5D mapping.
I'm also a frequent contributor (Q and A) at gis.stackexchange.com

Happy also to work on this 4 (or more) hands if anyone else wants to help
out. Otherwise, I'll sit back this week and accept with gratitude any
additional suggestions of what to cover or how. I'll then come back with a
1st (but doubtlessly incomplete) draft next week.

Martin Pergler




--
Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Jorge Gustavo Rocha]

Hi,

Thanks for stepping up, Martin.

I would like to add a single suggestion: to make a clear distinction
between QGIS and QGIS Server. If necessary, I can help/review QGIS
Server description.

Regards,

Jorge Gustavo


Às 01:15 de 16/02/21, Martin Pergler escreveu:

> Happy to take this on (next week, this week is a bit crazy).
> I like all 3 examples given: key thing being leading off much more with an
> easy-to-understand, illustrated list of main functionality and use cases.
>
> By way of introduction, 30 years ago I was a software developer, back when
> Pascal and C (++ was cutting edge!) were mainstream and Prolog was sexy (at
> least for geeks, that is). I then became a mathematician for a while, before
> going into business consulting. I've done a fair amount of technical writing
> and ran an editorial board for a while. My day job is now risk consulting,
> including probabilistic modeling, Excel/VBA, and R. On the side I help
> manage and preserve a decent chunk of Canadian wilderness, through which in
> the past couple of years I've become more and more involved in GIS. First,
> just making a map of the darned thing, but more recently vegetation and
> land-use analysis, indexing of research notes and wildlife photos,
> automation so others can use it, and even more recently UAV 2.5D mapping.
> I'm also a frequent contributor (Q and A) at gis.stackexchange.com
>
> Happy also to work on this 4 (or more) hands if anyone else wants to help
> out. Otherwise, I'll sit back this week and accept with gratitude any
> additional suggestions of what to cover or how. I'll then come back with a
> 1st (but doubtlessly incomplete) draft next week.
>
> Martin Pergler
>
>
>
>
> --
> Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
> _______________________________________________
> QGIS-Developer mailing list
> [hidden email]
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>

J. Gustavo
--
Jorge Gustavo Rocha
Departamento de Informática
Universidade do Minho
4710-057 Braga
Gabinete 3.29 (Piso 3)
Tel: [phone]
Fax: [phone]
Móvel: [phone]
skype: nabocudnosor
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Alexandre Neto]

There should be already some description on the QGIS Server documentation:

https://docs.qgis.org/3.16/en/docs/server_manual/introduction.html

Alexandre Neto

A terça, 16/02/2021, 09:11, Jorge Gustavo Rocha <[hidden email]> escreveu:

Hi,

Thanks for stepping up, Martin.

I would like to add a single suggestion: to make a clear distinction
between QGIS and QGIS Server. If necessary, I can help/review QGIS
Server description.

Regards,

Jorge Gustavo


Às 01:15 de 16/02/21, Martin Pergler escreveu:
> Happy to take this on (next week, this week is a bit crazy).
> I like all 3 examples given: key thing being leading off much more with an
> easy-to-understand, illustrated list of main functionality and use cases.
>
> By way of introduction, 30 years ago I was a software developer, back when
> Pascal and C (++ was cutting edge!) were mainstream and Prolog was sexy (at
> least for geeks, that is). I then became a mathematician for a while, before
> going into business consulting. I've done a fair amount of technical writing
> and ran an editorial board for a while. My day job is now risk consulting,
> including probabilistic modeling, Excel/VBA, and R. On the side I help
> manage and preserve a decent chunk of Canadian wilderness, through which in
> the past couple of years I've become more and more involved in GIS. First,
> just making a map of the darned thing, but more recently vegetation and
> land-use analysis, indexing of research notes and wildlife photos,
> automation so others can use it, and even more recently UAV 2.5D mapping.
> I'm also a frequent contributor (Q and A) at gis.stackexchange.com
>
> Happy also to work on this 4 (or more) hands if anyone else wants to help
> out. Otherwise, I'll sit back this week and accept with gratitude any
> additional suggestions of what to cover or how. I'll then come back with a
> 1st (but doubtlessly incomplete) draft next week.
>
> Martin Pergler
>
>
>
>
> --
> Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
> _______________________________________________
> QGIS-Developer mailing list
> [hidden email]
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>

J. Gustavo
--
Jorge Gustavo Rocha
Departamento de Informática
Universidade do Minho
4710-057 Braga
Gabinete 3.29 (Piso 3)
Tel: [phone]
Fax: [phone]
Móvel: [phone]
skype: nabocudnosor
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Ben Hur Pintor-3]

Hi Martin,

I would like to help you with this in case you need it. I'm fairly comfortable with both QGIS' capabilities and working with Markdown. Do let me know how I can help and how we can collaborate.

Thanks!

All the best,

Ben Hur

On Tue, Feb 16, 2021 at 9:15 AM Martin Pergler <[hidden email]> wrote:

Happy to take this on (next week, this week is a bit crazy).
I like all 3 examples given: key thing being leading off much more with an
easy-to-understand, illustrated list of main functionality and use cases.

By way of introduction, 30 years ago I was a software developer, back when
Pascal and C (++ was cutting edge!) were mainstream and Prolog was sexy (at
least for geeks, that is). I then became a mathematician for a while, before
going into business consulting. I've done a fair amount of technical writing
and ran an editorial board for a while. My day job is now risk consulting,
including probabilistic modeling, Excel/VBA, and R. On the side I help
manage and preserve a decent chunk of Canadian wilderness, through which in
the past couple of years I've become more and more involved in GIS. First,
just making a map of the darned thing, but more recently vegetation and
land-use analysis, indexing of research notes and wildlife photos,
automation so others can use it, and even more recently UAV 2.5D mapping.
I'm also a frequent contributor (Q and A) at gis.stackexchange.com

Happy also to work on this 4 (or more) hands if anyone else wants to help
out. Otherwise, I'll sit back this week and accept with gratitude any
additional suggestions of what to cover or how. I'll then come back with a
1st (but doubtlessly incomplete) draft next week.

Martin Pergler




--
Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Martin Pergler]

As per the thread last week, with the help of Jorge Gustavo Rocha (regarding
server) and Ben Hur Pintor, I've taken a first crack at revising the Github
landing page to be more exciting, up-to-date, and visual.

The current draft is at
https://github.com/Houska1/QGIS/blob/README-md-update/README.md; all
comments welcome (here, there, or by email to [hidden email]).

At this stage, I'd love to get buy in on the overall structure, and the
choice of the 5 high-level points under Features. We can then hunt for
better illustrations for each -- right now, I grabbed something from the
user manual or qgis.org gallery for each one, but we can probably do better.
Might even make sense to make something custom at a better image
size/resolution (but only once we're collectively happy we have the right
points to illustrate...).

Cheers,
Martin



--
Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Tyler Eshelman]

Hello everyone,

This is my first time replying to these emails since joining the QGIS development list.

Besides the landing page, are there any other beginner tasks that you have in mind for someone to begin contributing to this project?

Please let me know when you have a moment free.

Respectfully,

Tyler

—

On Mon, Feb 22, 2021 at 6:54 PM Martin Pergler <[hidden email]> wrote:

As per the thread last week, with the help of Jorge Gustavo Rocha (regarding
server) and Ben Hur Pintor, I've taken a first crack at revising the Github
landing page to be more exciting, up-to-date, and visual.

The current draft is at
https://github.com/Houska1/QGIS/blob/README-md-update/README.md; all
comments welcome (here, there, or by email to [hidden email]).

At this stage, I'd love to get buy in on the overall structure, and the
choice of the 5 high-level points under Features. We can then hunt for
better illustrations for each -- right now, I grabbed something from the
user manual or qgis.org gallery for each one, but we can probably do better.
Might even make sense to make something custom at a better image
size/resolution (but only once we're collectively happy we have the right
points to illustrate...).

Cheers,
Martin



--
Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[lejedi76]

Hi Martin,

I have the impression that it's not suitable for small screen ? Do you confirm ?

Le mar. 23 févr. 2021 à 09:08, Tyler Eshelman <[hidden email]> a écrit :

Hello everyone,

This is my first time replying to these emails since joining the QGIS development list.

Besides the landing page, are there any other beginner tasks that you have in mind for someone to begin contributing to this project?

Please let me know when you have a moment free.

Respectfully,

Tyler

—

On Mon, Feb 22, 2021 at 6:54 PM Martin Pergler <[hidden email]> wrote:

As per the thread last week, with the help of Jorge Gustavo Rocha (regarding
server) and Ben Hur Pintor, I've taken a first crack at revising the Github
landing page to be more exciting, up-to-date, and visual.

The current draft is at
https://github.com/Houska1/QGIS/blob/README-md-update/README.md; all
comments welcome (here, there, or by email to [hidden email]).

At this stage, I'd love to get buy in on the overall structure, and the
choice of the 5 high-level points under Features. We can then hunt for
better illustrations for each -- right now, I grabbed something from the
user manual or qgis.org gallery for each one, but we can probably do better.
Might even make sense to make something custom at a better image
size/resolution (but only once we're collectively happy we have the right
points to illustrate...).

Cheers,
Martin



--
Sent from: http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Jorge Gustavo Rocha]

Hi all,

Nice work, Martin!

Yes, the text itself and the images are not properly formatted.

Right now the goal is to validate and improve the structure and the key
arguments, as I understand. Afterwards, images can be improved and
properly formatted in  markdown.

I think everyone can edit this proposal in place, to submit improvements
as a PR. Matthias already did it. My contribution just landed there.

https://github.com/Houska1/QGIS/edit/README-md-update/README.md

Regards,

Jorge

Às 08:29 de 23/02/21, JD L escreveu:

> Hi Martin,
> I have the impression that it's not suitable for small screen ? Do you
> confirm ?
>
>
> Le mar. 23 févr. 2021 à 09:08, Tyler Eshelman <[hidden email]
> <mailto:[hidden email]>> a écrit :
>
>     Hello everyone,
>
>     This is my first time replying to these emails since joining the
>     QGIS development list.
>     Besides the landing page, are there any other beginner tasks that
>     you have in mind for someone to begin contributing to this project?
>
>     Please let me know when you have a moment free.
>
>     Respectfully,
>
>     Tyler
>
>     —
>
>     On Mon, Feb 22, 2021 at 6:54 PM Martin Pergler <[hidden email]
>     <mailto:[hidden email]>> wrote:
>
>         As per the thread last week, with the help of Jorge Gustavo
>         Rocha (regarding
>         server) and Ben Hur Pintor, I've taken a first crack at revising
>         the Github
>         landing page to be more exciting, up-to-date, and visual.
>
>         The current draft is at
>         https://github.com/Houska1/QGIS/blob/README-md-update/README.md; all
>         comments welcome (here, there, or by email to [hidden email]
>         <mailto:[hidden email]>).
>
>         At this stage, I'd love to get buy in on the overall structure,
>         and the
>         choice of the 5 high-level points under Features. We can then
>         hunt for
>         better illustrations for each -- right now, I grabbed something
>         from the
>         user manual or qgis.org <http://qgis.org> gallery for each one,
>         but we can probably do better.
>         Might even make sense to make something custom at a better image
>         size/resolution (but only once we're collectively happy we have
>         the right
>         points to illustrate...).
>
>         Cheers,
>         Martin
>
>
>
>         --
>         Sent from:
>         http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
>         _______________________________________________
>         QGIS-Developer mailing list
>         [hidden email]
>         <mailto:[hidden email]>
>         List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>         Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>
>     _______________________________________________
>     QGIS-Developer mailing list
>     [hidden email] <mailto:[hidden email]>
>     List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>     Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>
>
> _______________________________________________
> QGIS-Developer mailing list
> [hidden email]
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>

J. Gustavo
--
Jorge Gustavo Rocha
Departamento de Informática
Universidade do Minho
4710-057 Braga
Gabinete 3.29 (Piso 3)
Tel: [phone]
Fax: [phone]
Móvel: [phone]
skype: nabocudnosor
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

[Ben Hur Pintor-3]

+1 on adding geometry generators as a bullet point.

I was thinking that aside from the screenshot/images, we can also add links directly to the bullet points that would send readers/users to a good resource discussing that bullet point/feature. There are already quite a number of good resources (e.g. videos and blog posts by the community -- videos and posts by Klas, Anita, Nyall, Tim, etc. -- as well as the official documentation) discussing some of the features we want to highlight. Might be good to have those on the README as well.

All the best,

Ben Hur

On Tue, Feb 23, 2021 at 7:34 PM Jorge Gustavo Rocha <[hidden email]> wrote:

Hi all,

Nice work, Martin!

Yes, the text itself and the images are not properly formatted.

Right now the goal is to validate and improve the structure and the key
arguments, as I understand. Afterwards, images can be improved and
properly formatted in  markdown.

I think everyone can edit this proposal in place, to submit improvements
as a PR. Matthias already did it. My contribution just landed there.

https://github.com/Houska1/QGIS/edit/README-md-update/README.md

Regards,

Jorge

Às 08:29 de 23/02/21, JD L escreveu:
> Hi Martin,
> I have the impression that it's not suitable for small screen ? Do you
> confirm ?
>
>
> Le mar. 23 févr. 2021 à 09:08, Tyler Eshelman <[hidden email]
> <mailto:[hidden email]>> a écrit :
>
>     Hello everyone,
>
>     This is my first time replying to these emails since joining the
>     QGIS development list.
>     Besides the landing page, are there any other beginner tasks that
>     you have in mind for someone to begin contributing to this project?
>
>     Please let me know when you have a moment free.
>
>     Respectfully,
>
>     Tyler
>
>     —
>
>     On Mon, Feb 22, 2021 at 6:54 PM Martin Pergler <[hidden email]
>     <mailto:[hidden email]>> wrote:
>
>         As per the thread last week, with the help of Jorge Gustavo
>         Rocha (regarding
>         server) and Ben Hur Pintor, I've taken a first crack at revising
>         the Github
>         landing page to be more exciting, up-to-date, and visual.
>
>         The current draft is at
>         https://github.com/Houska1/QGIS/blob/README-md-update/README.md; all
>         comments welcome (here, there, or by email to [hidden email]
>         <mailto:[hidden email]>).
>
>         At this stage, I'd love to get buy in on the overall structure,
>         and the
>         choice of the 5 high-level points under Features. We can then
>         hunt for
>         better illustrations for each -- right now, I grabbed something
>         from the
>         user manual or qgis.org <http://qgis.org> gallery for each one,
>         but we can probably do better.
>         Might even make sense to make something custom at a better image
>         size/resolution (but only once we're collectively happy we have
>         the right
>         points to illustrate...).
>
>         Cheers,
>         Martin
>
>
>
>         --
>         Sent from:
>         http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-f4099106.html
>         _______________________________________________
>         QGIS-Developer mailing list
>         [hidden email]
>         <mailto:[hidden email]>
>         List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>         Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>
>     _______________________________________________
>     QGIS-Developer mailing list
>     [hidden email] <mailto:[hidden email]>
>     List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>     Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>
>
> _______________________________________________
> QGIS-Developer mailing list
> [hidden email]
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>

J. Gustavo
--
Jorge Gustavo Rocha
Departamento de Informática
Universidade do Minho
4710-057 Braga
Gabinete 3.29 (Piso 3)
Tel: [phone]
Fax: [phone]
Móvel: [phone]
skype: nabocudnosor
_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

_______________________________________________
QGIS-Developer mailing list
[hidden email]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer