notebooks icon indicating copy to clipboard operation
notebooks copied to clipboard

[WIP] add intro draft

Open knaaptime opened this issue 5 years ago • 5 comments

here's a start on the intro. my intent was to describe a bit of the motivation for the book project and use serge's paper to give a bit of background on the current structure. let me know if you'd like to take it in another direction (or if there are details I borked) and i can keep plugging away

knaaptime avatar Jul 24 '19 17:07 knaaptime

oops--i'd intented to replace that first #PySAL heading with something more descriptive

knaaptime avatar Jul 24 '19 17:07 knaaptime

is it possible to reorder the chapters so they follow the same outline described here (lib -> explore -> viz -> model) ?

not that it's necessarily the perfect sequence, but it seems to me we should put lib first?

knaaptime avatar Jul 24 '19 17:07 knaaptime

As for the re-ordering of the chapters, it's definitely posible though it'd take a bit of refactoring of the code. We currently simply pull the folders in the order they appear when downloaded:

https://github.com/pysal/notebooks/blob/master/lib/build.py#L150

I'm not sure what the most straightforward way would be to re-arrange as desired in an automated way. PRs most welcome :-)

darribas avatar Jul 25 '19 07:07 darribas

As for the re-ordering of the chapters, it's definitely posible though it'd take a bit of refactoring of the code. We currently simply pull the folders in the order they appear when downloaded:

https://github.com/pysal/notebooks/blob/master/lib/build.py#L150

I'm not sure what the most straightforward way would be to re-arrange as desired in an automated way. PRs most welcome :-)

Would it be possible to change the ordering by editing https://github.com/pysal/notebooks/blob/master/docs/_data/toc.yml ?

sjsrey avatar Jul 25 '19 14:07 sjsrey

Yes, you could change it there but everything in docs is automatically built by lib/build.py so you'd have to make a manual edit everytime it gets built. We should probably think of a way to insert it when the toc is being built...

darribas avatar Jul 25 '19 15:07 darribas