Browse Source

some "about the future" docs stuff

Paul Liverman III 6 years ago
parent
commit
366f1a62b5
1 changed files with 63 additions and 0 deletions
  1. 63
    0
      views/docs/v1.moon

+ 63
- 0
views/docs/v1.moon View File

@@ -59,6 +59,8 @@ class Docs_1 extends Widget
59 59
         a href: "#errors", "Errors"
60 60
       li ->
61 61
         a href: "#rate-limit", "Rate Limiting"
62
+      li ->
63
+        a href: "#changes", "Changes"
62 64
 
63 65
     a name: "endpoints"
64 66
     h2 "Endpoints"
@@ -312,3 +314,64 @@ class Docs_1 extends Widget
312 314
     p "At this time there is no rate limiting. This will be developed when needed, and the API documentation updated to reflect that, with at least 2 months' warning."
313 315
 
314 316
     a class: ".top", href: "#top", "back to top"
317
+    a name: "changes"
318
+    h2 "Changes"
319
+
320
+    p "I intend to keep support for v1 of the API indefinitely. If new features require backwards-incompatible API changes, those will be released under a new version of the API, and v1 will remain accessible for at least 6 months before switching."
321
+
322
+    p "All new features that do not require modifications to existing API calls will be added to v1 as they are introduced. The next version of the API will only exist if backwards-incompatible changes are introduced."
323
+
324
+    a class: ".top", href: "#top", "back to top"
325
+    a name: "next"
326
+    h2 "Coming Next"
327
+
328
+    p "Until I implement an a tracking system for features/bugs, here is a brief list of features to be added 'soon', and a few known bugs:"
329
+
330
+    ul ->
331
+      li ->
332
+        text "Implementing "
333
+        code "/random"
334
+        text " endpoint."
335
+      li ->
336
+        code "/edit"
337
+        text " endpoint for modifying the "
338
+        code "content"
339
+        text " of a task. The web interface will also be updated to utilize this."
340
+      li ->
341
+        code "/search"
342
+        text " endpoint. The web interface will also be updated to utilize this."
343
+      li "Lists (including the ability to have lists of lists). The API and web interface will receive several updates for this."
344
+      li ->
345
+        code "/duplicate"
346
+        text " endpoint for duplicating a task or list (with optional inclusion of any sub-tasks/sub-lists). The web interface will be updated to utilize this."
347
+      li "CLI program for interacting with the API."
348
+      li class: "error", ->
349
+        text "BUG: IDs are not returned with requests to "
350
+        code "/key/new"
351
+        text " endpoint."
352
+      li "Twitter integration."
353
+      li "Data export. (Note: Initially will be a large JSON dump, but you can contact me if you have special needs for data export and I will develop these upon request.)"
354
+
355
+    p "And this is a list of ideas that may or may not be coming a bit later on, still being thought about:"
356
+
357
+    ul ->
358
+      li "Email integration."
359
+      li "Reminders."
360
+      li "Recurring tasks."
361
+      li "Shared tasks."
362
+      li "Customization of web interface. (e.g. select between current interface and a kanban-style board)"
363
+      li "Reordering tasks/lists. (This one requires some research on my part of how to implement this efficiently.)"
364
+      li "Tagging system (for tasks/lists)."
365
+      li "Due dates/times."
366
+      li "Webhooks."
367
+      li "OAuth2 support."
368
+      li "Import from other todo/task management software."
369
+
370
+    p "Finally, this is a list of a few site-related things I need to get set up:"
371
+
372
+    ul ->
373
+      li "A homepage for non-users showing features / enticing sign-up. Of course. :P"
374
+      li "A dynamically updated page showing project status, both in terms of budget (income/expenses) and features/bugs. (This will also allow users to vote for features/bugs to be prioritized.)"
375
+      li "A page for accepting payments. At this stage, this is optional and I will be relying purely on people wanting to see this system succeed. In the future, more advanced API features may be behind a subscription model (intended to be $1.50/year)."
376
+
377
+    a class: ".top", href: "#top", "back to top"