Comments (4)
Thanks for the guidance -- sometime soon when I have time, I'll read through what we've got and see if I can reorganize/otherwise improve it a bit.
I like the idea about including an optional Markdown file alongside the poet script. That could perhaps even be a user-facing thing in the app, sort of like a little landing page for each poet where the poet could explain its M.O., hopes, dreams, and darkest fears.
from new-yorken-poesry-magazine.
Hey @ConnorWalsh, I was enthralled by your talk at Strange Loop the other day, and I'd like to take a stab at writing a poet or two. I'd be happy to start writing a rudimentary tutorial while I'm doing that.
Do you have any recommendations for where to start, best de facto references at the moment, etc.?
from new-yorken-poesry-magazine.
hiiii @daveyarwood! sorry for my late response! past couple weeks have been very busy for me! I'm so happy you enjoyed it and that you want to contribute!
Yes, I'd love a helping hand with the tutorial! Currently there is a little section in the README which describes from a black box perspective how a poet should be able to interact with/support certain command line arguments. I'm afraid it isn't written in a way that is extremely clear and intuitive (which is the goal-- accessibility is the goal here ^-^).
A good starting point could be reading this and trying to reorganize it s.t. it is more clear. Ideally, i think pipi_sauvage
would like the tutorial to have a high level description about how the minimum, black box requirements a poet should satisfy (those are what is attempted inthe README), but also real code snippets for simple poets written in all the supported languages. I think pipi
also loves pictures and diagrams, so a less-text, more-visual tutorial feels like the right way to go.
Additionally, it would be really fun if there were more in depth descriptions of how to write more sophisticated poets which was kind of the idea behind exposing the code for each poet publicly. maybe there can be another optional file uploaded alongside poets (like a markdown file or something) which can serve as a more readable, in depth description on how a poet was created. I like this idea because in a sense, it means that the tutorial can have a glossary of working code examples which are provided by the community of poet designers. This also gives designers a nice opportunity to share all the work they'done in a way which would also benefit others.
thanks again for your interest! pipi
is very happy about it!
from new-yorken-poesry-magazine.
@daveyarwood i made an separate issue for the markdown file idea here if your interested: #58
from new-yorken-poesry-magazine.
Related Issues (20)
- switch over to `sqlx` HOT 1
- ask poet to generate poem as part of API HOT 1
- Test All Supported Languages
- Support User & Poet Soft Deletion
- Limit # of Poets User Can Upload
- Fix File Upload UI
- Display Errors on Frontend
- Language Third Party Packages
- Favicon & Logo HOT 2
- Get DB Migration Tools Setup
- Setup Email System for users HOT 1
- Clojure support HOT 2
- Poet Error Console HOT 3
- Support Optional Markdown Explanation of Poets
- Mobile-friendly poem.computer HOT 2
- email Verification
- UI Refactor -> ASCII
- Selected Works, issues HOT 3
- Genetic Programming Poet HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from new-yorken-poesry-magazine.