seem
(Wasim Lorgat)
September 13, 2022, 10:31pm
1
One of nbdev’s major goals is to enable non-devs to publish reusable software in their domains
We’ve reworked the walkthrough to include everything you need to know to get started, from installing Python to having your package’s own website
Check it out here and let us know what you think in this topic: nbdev - End-to-end walkthrough
Many thanks to @Ezno for doing lots of the initial work on this!
12 Likes
Daniel
(深度碎片)
September 14, 2022, 2:42am
2
This version is amazingly detailed and covered a lot more than the previous one! Thanks!
2 Likes
yegeniy
(Eugene Wolfson)
September 15, 2022, 3:40am
3
This is fantastic @seem ,
The recent documentation improvements are just top notch. With the polish that has gone into nbdev the past few versions, it really feels like this project is ready to go mainstream.
Before, I felt comfortable using nbdev to write production code.
But now, I do not feel guilty that my co-workers have to learn it.
4 Likes
bencoman
(Ben Coman)
September 20, 2022, 4:10am
4
Reporting my experience following the walkthrough.
At the section “Check out your workflows ”, when I click on Actions I don’t see the following…
but see this instead…
I notice the fastai repo has a “workflows” folder…
which mine does not…
But the folder did exist in my local repo.
So to fix this I did the following…
$ git add -f .github
$ git commit -m'Add workflows'
$ git push
Without the “-f” it would error with…
The following paths are ignored by one of your .gitignore files:
.github
seem
(Wasim Lorgat)
September 20, 2022, 6:56am
5
Interesting. .github
isn’t in the nbdev-template .gitignore file . I noticed that your repo doesn’t have a .gitignore file either. Is it possible that you’ve configured a global gitignore?
2 Likes
bencoman
(Ben Coman)
September 20, 2022, 7:31am
6
Spot on! I don’t remember doing it, but there it is.
$ cat ~/.gitignore
*~
*.swp
.*
I guess at some point I decided it was good practice that hidden files/folders not be auto-committed, but not sure if thats recommended.
2 Likes