perl-poet icon indicating copy to clipboard operation
perl-poet copied to clipboard

Dubious location of database in Tutorial?

Open thaljef opened this issue 12 years ago • 3 comments

In the Tutorial, the database is put into the data/ directory. But elsewhere in the documentation, the data/ directory is described as a place for "transient data, such as caches". The database hardly seems transient. Strangely, the db/ directory is where the SQL goes, but not the database itself.

Consider improving the description of these directories. Or if appropriate, give them more correct names.

thaljef avatar Sep 28 '12 03:09 thaljef

Yeah - I guess I didn't think about this hard because it would only matter for a demo using sqlite -- on a real website the database would be off on its own server. But I'll make a note about this or move it to db/ or something.

Jon

On Sep 27, 2012, at 8:20 PM, Jeffrey Ryan Thalhammer wrote:

In the Tutorial, the database is put into the data/ directory. But elsewhere in the documentation, the data/ directory is described as a place for "transient data, such as caches". The database hardly seems transient. Strangely, the db/ directory is where the SQL goes, but not the database itself.

Consider improving the description of these directories. Or if appropriate, give them more correct names.

— Reply to this email directly or view it on GitHub.

jonswar avatar Oct 01 '12 11:10 jonswar

On Oct 1, 2012, at 4:54 AM, Jonathan Swartz wrote:

Yeah - I guess I didn't think about this hard because it would only matter for a demo using sqlite -- on a real website the database would be off on its own server. But I'll make a note about this or move it to db/ or something.

Well I'm using sqlite, so a local directory for the database probably makes a lot of sense. I just think the descriptions of the data/ and db/ directories need to be clarified a bit (at least for a novice like me). I appreciate that Poet is so neatly organized. Catalyst -- not so much.

-Jeff

thaljef avatar Oct 01 '12 18:10 thaljef

On Oct 1, 2012, at 11:44 AM, Jeffrey Ryan Thalhammer wrote:

On Oct 1, 2012, at 4:54 AM, Jonathan Swartz wrote:

Yeah - I guess I didn't think about this hard because it would only matter for a demo using sqlite -- on a real website the database would be off on its own server. But I'll make a note about this or move it to db/ or something.

Well I'm using sqlite, so a local directory for the database probably makes a lot of sense. I just think the descriptions of the data/ and db/ directories need to be clarified a bit (at least for a novice like me). I appreciate that Poet is so neatly organized. Catalyst -- not so much.

Yeah, fair enough. The data/ directory is really characterized by "anything that isn't checked into version control" - so a sqlite database would belong there, rather than in db/, which is for checked-in sql files. I'll make this more clear.

Jon

jonswar avatar Oct 02 '12 07:10 jonswar