These are chat archives for PerfectlySoft/PerfectDocs

14th
Jul 2016
Jonathan Guthrie
@iamjono
Jul 14 2016 13:46
Hi everyone! Welcome to the new PerfectDocs room :)
I’ve updated the README on GitHub with some verbiage, and a table of contents
Ryan Collins
@rymcol
Jul 14 2016 14:13
@iamjono Suggestion: Where there are empty stubs, change the "…" to "Assigned - @iamjono" when someone picks up a topic. That way it’s easy to scout what still needs to be done.
Jonathan Guthrie
@iamjono
Jul 14 2016 14:13
Excellent
Any you would like to pick up?
Ryan Collins
@rymcol
Jul 14 2016 14:15
I was considering SQLite
and maybe MySQL
Jonathan Guthrie
@iamjono
Jul 14 2016 14:15
I’m in the middle of the MongoDB docs
Ryan Collins
@rymcol
Jul 14 2016 14:15
becuase I’ve worked with them quite a bit lately
Jonathan Guthrie
@iamjono
Jul 14 2016 14:15
That would be awesome :)
I’ll assign those to you now
And the great thing is that in the latest commit comment showing, it’s then also easy to see it’s assigned
Ryan Collins
@rymcol
Jul 14 2016 14:18
Exactly
Kyle Jessup
@kjessup
Jul 14 2016 14:31
I'm changing up the Routing API so don't do anything there yet, please
Jonathan Guthrie
@iamjono
Jul 14 2016 14:32
yep I’ll make sure no-one gets assigned to those yet
Kyle Jessup
@kjessup
Jul 14 2016 14:32
I put my name on it
Ryan Collins
@rymcol
Jul 14 2016 14:32
@kjessup changing it how…
lol
Tim Taplin
@taplin
Jul 14 2016 14:33
yeah, that’s kind of a scary statement...
Kyle Jessup
@kjessup
Jul 14 2016 14:34
Changing the APi so that you add the routes to the server instead of them being global. It will have full backward compatibility with a "deprecated" warning only - so nothing should break :)
Jonathan Guthrie
@iamjono
Jul 14 2016 14:36
@taplin, @rymcol there was an offline discussion yesterday here locally, about the fact that if it was going to change, now would be the time to do it… and as Kyle said above, protecting the existing solutions out there too.
Ryan Collins
@rymcol
Jul 14 2016 14:36
are you prepping to have multiple server instances for hosting more than one website/app in the same binary by making the routes app-specific?
Kyle Jessup
@kjessup
Jul 14 2016 14:36
That is one benefit
A simple common case is to have a non-ssl server redirect everything to the SSL srvr
Ryan Collins
@rymcol
Jul 14 2016 14:38
Which is a very, very common use case I’m sure.
Jonathan Guthrie
@iamjono
Jul 14 2016 15:08
The MongoDB section is actually more complex than I thought… I’m going to have to document the BSON usage etc too...
Fun :)
Tim Taplin
@taplin
Jul 14 2016 15:09
yeah thats where I started on documentation
and the documentation from the Mongo side is pretty sparse as well
Jonathan Guthrie
@iamjono
Jul 14 2016 15:09
? on the mongo section?
Tim Taplin
@taplin
Jul 14 2016 15:10
the jazzy docs for the MongoDB connecto
Jonathan Guthrie
@iamjono
Jul 14 2016 15:10
right
Tim Taplin
@taplin
Jul 14 2016 15:10
connector
Jonathan Guthrie
@iamjono
Jul 14 2016 15:10
would be good then if after i’ve finished you parse my mongo docs for accuracy :)
Tim Taplin
@taplin
Jul 14 2016 15:11
hehe
I’m assuming that you’re using the jazzy docs as a reference point for some of what you’re doing ? on all this doc set ?
Jonathan Guthrie
@iamjono
Jul 14 2016 15:11
i’m actually using the code ;)
Jonathan Guthrie
@iamjono
Jul 14 2016 16:08
Your doc comments are proving invaluable, thanks @taplin
Tim Taplin
@taplin
Jul 14 2016 16:12
glad its useful
Kyle Jessup
@kjessup
Jul 14 2016 18:49
Done with the routing stuff and will be committing it soon. All the old tests pass so you guys should be ok :D
Jonathan Guthrie
@iamjono
Jul 14 2016 18:49
awesome!
you gonna write the docs for it?
Kyle Jessup
@kjessup
Jul 14 2016 18:52
yes
Jonathan Guthrie
@iamjono
Jul 14 2016 18:52
:)
Ryan Collins
@rymcol
Jul 14 2016 20:26
Let me know when you tag it
Did you test it with mustache?
Kyle Jessup
@kjessup
Jul 14 2016 20:27
I tagged it
Ryan Collins
@rymcol
Jul 14 2016 20:27
ty
Kyle Jessup
@kjessup
Jul 14 2016 20:27
I just updated the Uploads example which uses mustache. it worked
Ryan Collins
@rymcol
Jul 14 2016 20:27
sweet
Jonathan Guthrie
@iamjono
Jul 14 2016 20:52
ok, completed MongoDB (main). MongoCollections, BSON
For completeness I should probably do MongoClient, MongoDatabase
Jonathan Guthrie
@iamjono
Jul 14 2016 21:57
Done
Kyle Jessup
@kjessup
Jul 14 2016 23:05
BTW @taplin I massaged and brought in your syslog related log work. I don't think I mentioned it https://github.com/PerfectlySoft/Perfect/blob/master/Sources/PerfectLib/Log.swift
Tim Taplin
@taplin
Jul 14 2016 23:09
cool, hopefully you didnt have to do too much massaging ?
Kyle Jessup
@kjessup
Jul 14 2016 23:10
not really. you're stuff was a good way there