Opened 10 years ago
Closed 6 years ago
#1085 closed enhancement (fixed)
PostGIS Quickstart review - remove command line description?
|Reported by:||camerons||Owned by:|
|Component:||OSGeoLive||Keywords:||postgis, docs, 7.5|
I've added the follow review comments into the PostGIS quickstart:
For this quickstart, which targets new users who might not be familiar with databases or SQL, I suggest we drop section describing command line control of Postgres. If we do keep command line information, I suggest it is moved to the end of the quickstart, possibly added into "Things you could try". Instead, I think the Quickstart should cover:
- Keep Client/Server overview
- Create a database in pgAdmin
- Load a dataset, probably from a shapefile
- Do some SQL queries on the dataset
- Use QGis to view data from PostGIS (using the existing Natural Earth data). We should be able to keep most of the existing QGis sections
Change history (11)
comment:1 by , 10 years ago
|Type:||defect → enhancement|
comment:2 by , 10 years ago
I'm ok with keeping the Command Line section in the Quickstart, as long as it is comes in after the GUI description. (The Spatialite DB Quickstart has just been restructured into this format).
comment:3 by , 10 years ago
|Summary:||PostGIS Quickstart review - remove command line description → PostGIS Quickstart review - remove command line description?|
With respect to the command line stuff in PostGIS (if you could call it that, it's not arcane bash tricks or anything, just simple one liners in the psql environ which any SQL-literate reader will be right at home with) -- any sort of spatial query or equation is going to be done at that level.
pgadmin3 is a fine program, and a great way to visualize and explore how the DB is put together, but this isn't a tutorial on how to easily manage or tweak a DB -- it's a tutorial on how to do spatial analyses. pgadmin3 is just the nice data explorer along side.
If the command line is the best (i.e. most concise) or only place to perform some action then that is what should be presented. So I'm with Brian on this one, irrational fear of the command line [i.e. unknown] is something which should be actively and explicitly combated with the gentle introduction of (understandable) one liners. I'm not too worried about the order of the page where it doesn't harm the logical progression, but the content should remain where it is the best tool for the job.
comment:4 by , 10 years ago
I just went through the PostGIS Quickstart and I think that it is of high quality. I agree that we should not remove all the CLI stuff. Perhaps we can just push the GUI part on the top of the guide.
comment:5 by , 10 years ago
|Keywords:||7.0 added; 6.5 removed|
|Milestone:||OSGeoLive6.5 → OSGeoLive7.0|
Agreed in IRC meeting (pre osgeolive 6.5 release) that we should move the Command Line text to the end of the Quickstart, so long as the story still flows. Moving this to be fixed for 7.0 release.
comment:6 by , 10 years ago
I suggest we close this ticket for 7.0
comment:7 by , 10 years ago
|Keywords:||7.5 added; 7.0 removed|
|Milestone:||OSGeoLive7.0 → OSGeoLive7.5|
moved to next release
comment:8 by , 9 years ago
|Milestone:||OSGeoLive7.9 → OSGeoLive8.0|
comment:9 by , 6 years ago
- Do will still want to change the quickstart? I.e. move command line part to the bottom?
comment:10 by , 6 years ago
I think we should close this ticket.
comment:11 by , 6 years ago
|Status:||new → closed|
I am of the opinion that eliminating the command line from quickstarts systematically is a mistake; that a GUI should be used for the quickstart whenever possible; and that existing materials that are sound, should not be thrown away