Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
    Ryan Collins
    @rymcol
    That way if the template changes, it’s readme changes, and there’s no scrabling to update x other guides
    Also, we were chatting a while ago about a standard config file for things like IP, Port, Database Info, etc.. and were debating the value of something like a plist for it. I realized here that you do your setup much differently than I do (I make a struct called config and put all my connection info in that). Which makes me think it might be a good time to think about standardizing that, so the documentation will be more digestable for people investing time in the platform.
    But that’s a big change, so it should probably be discussed first.
    Tim Taplin
    @taplin
    I do the same thing with my config info, but did not think that type of default should be forced on a quickstart setup
    I would welcome some discussion on what the best method is to store and include credentials and settings relating to database, external api’s, and other sensitive info for our server side projects.
    I try to keep the credential setup to a minimum, and store as much as possible in a datasource
    I think that we could potentially link to a readme on the PerfectTemplate, although I dont tend to use it for anything myself
    Kyle Jessup
    @kjessup
    Added routing, if anyone wants to give it a check https://github.com/PerfectlySoft/PerfectDocs/blob/master/guide/routing.md
    Jonathan Guthrie
    @iamjono
    reading now/...
    Kyle Jessup
    @kjessup
    Regarding the MySQL quickstart information. The database connectors do not require or use PerfectLib or the server in any way, yet all the new information pulls those in
    Tim Taplin
    @taplin
    I guess that I was looking to have a quick start example which would result in a functioning project and not something just in abstract. I took some cues from the currently outdated MongoDB example which works similarly.
    we could remove the dependencies and have a more bare bones quickstart if that is the preference
    Kyle Jessup
    @kjessup
    Oh I didn't realize mongo was the same way. I don't think I did that.
    Tim Taplin
    @taplin
    I understand your point about the connector not depending on PerfectLib or the HTTPServer, but I think there could be arguments on both sides, and we should have a clear decision, and maintain that consistently thru these quickstart examples
    I am happy to update both quickstarts accordingly given some direction, and then will continue to produce further quickstarts consistent with that decision.
    Kyle Jessup
    @kjessup
    I think that if the words Quick Start were changed to something like Example Usage or the like and they included a sentence saying this example shows how to use this module along with PerfectHTTPServer or something like that it would be less confusing
    Kyle Jessup
    @kjessup
    Who is working on what right now?
    I'm doing a quick redis-sessions module and then hitting request/response filters docs
    Tim Taplin
    @taplin
    I’m working on quickstarts, Postgres on deck at the moment
    Jonathan Guthrie
    @iamjono
    I’m working on the Static File Content docs
    then probably the multi part forms docs
    Ryan Collins
    @rymcol
    I'm doing the MySQL guide & the benchmarking project.
    Jonathan Guthrie
    @iamjono
    excellent
    Kyle Jessup
    @kjessup
    all the docs completed badges seem to be getting an error. I'm going to replace them with just text
    Jonathan Guthrie
    @iamjono
    Simple “Working with Form Data” guide docs:
    Jonathan Guthrie
    @iamjono
    Hey @taplin , just seen your PR come in… could you update the status of the task in Jira? Thanks!
    @rymcol please send me your email address so I can add you to Jira please?
    Jonathan Guthrie
    @iamjono
    nm, got your email from lucas, sent you the invite
    Ryan Collins
    @rymcol
    @iamjono thanks
    Jonathan Guthrie
    @iamjono
    np. Once you’re signed up, I can assign you things (like the MySQL docs)
    Ryan Collins
    @rymcol
    @iamjono taken care of
    Also MySQL doc is 75%, I should have a PR for you soon
    Jonathan Guthrie
    @iamjono
    awesome
    I see you’ve already got an avatar. Thanks!
    Ryan Collins
    @rymcol
    First thing I always do. I hate being a blank person.
    Jonathan Guthrie
    @iamjono
    hehe, exactly!
    Kyle Jessup
    @kjessup
    Hey so as I work on the HTTPRequest doc I see that there will be a lot of overlap with the subsections "formData" and "fileUploads". It might be a good idea to put all that content in one HTTPRequest document and have the subsections listed under that link to the sections within it. does this make sense?
    Jonathan Guthrie
    @iamjono
    Hmmm, yeah I’m documenting those more descriptively though
    We could put them as subsection documents under the HTTPRequest?
    Kyle Jessup
    @kjessup
    more descriptively than the non-existent HTTPRequest doc? I would hope so
    Jonathan Guthrie
    @iamjono
    hehe
    yeah
    Kyle Jessup
    @kjessup
    ok yeah that's fine. I will link to them then
    Jonathan Guthrie
    @iamjono
    hey as an aside… in Jira, click on the DOC-26 issue, press “a” and assign yourself ;)
    please
    Kyle Jessup
    @kjessup
    I did HTTPRequest, HTTPResponse and added more to Mustache
    We have so much done! just a few sections left.