Merge branch 'master' into contribution-notes

docs-sidebar.js

@@ -26,6 +26,7 @@ const unavailable = title => ({
 const sidebars = {
   docs: [
     'index',
+    'vision',
     'releases',
     {
       type: 'category',

docs/api/reference.md

@@ -134,13 +134,18 @@ If you want to create a transfer, use the transfer payee for the account you wis
 
 #### `addTransactions`
 
-<Method name="addTransactions" args={[{ name: 'accountId', type: 'id'}, { name: 'transactions', type: 'Transaction[]'}]} returns="Promise<id[]>" />
+<Method name="addTransactions" args={[{ name: 'accountId', type: 'id'}, { name: 'transactions', type: 'Transaction[]'}, { name: 'runTransfers = false', type: 'bool?'}, { name: 'learnCategories = false', type: 'bool?'}]} returns="Promise<id[]>" />
 
 Adds multiple transactions at once. Does not reconcile (see `importTransactions`). Returns an array of ids of the newly created transactions.
 
-If a transfer payee is given, this method does **not** create a transfer. Use `importTransactions` if you want to create transfers.
+This method does **not** avoid duplicates. Use `importTransactions` if you want the full reconcile behavior.
 
-You probably want to use `importTransactions`. This method is mainly for custom importers that want to skip all the automatic stuff because it wants to create raw data.
+This method has the following optional flags:
+
+- `runTransfers`:  create transfers for transactions where transfer payee is given (defaults to false)
+- `learnCategories`: update Rules based on the category field in the transactions (defaults to false)
+
+This method is mainly for custom importers that want to skip all the automatic stuff because it wants to create raw data. You probably want to use `importTransactions`.
 
 #### `importTransactions`
 

docs/vision.md

@@ -0,0 +1,59 @@
+---
+title: Actual Budget Vision
+---
+
+**Vision statement**: To produce a delightful budgeting tool that meets you wherever you are in your financial journey.
+
+**Mission statement**: Our mission is to enable everyone to have the opportunity to:
+* take charge of their finances
+* find financial peace of mind
+* actively engage in dreaming big and achieving your goals
+
+**Design principles**: Actual is designed using the following principles:
+* **Local-first**
+* **Open**
+* **Sleek and clutter-free**
+* **Stable**
+* **Reliable**
+* **Secure**
+* **Privacy focused**
+* **Community-driven**
+
+### Local-first
+
+Actual is local first, meaning that the database that powers Actual Budget, and ultimately your budget, lives on your device. We don't store it on a server. Now you're wondering, what 'actual server' is for? Well, that allows you to sync changes to your budget on different devices. To do this, only the changes to the budget are sent to the server. The server stores the messages, and the client pulls down the change(s).
+
+### Open 
+
+Actual is Open Source utilizing the MIT license. The code is open for anyone to see, view, and contribute. You own your data; you can do whatever you want with it.
+
+### User Interface
+
+The sleek and clutter-free user interface is simple to use for beginners and comes packed with a robust 'undo' system and progressive discoverability for advanced users. The responsive interface adapts to the screen size you are using to give you the best experience for that device. A desktop computer will have the full desktop experience designed to be used with a keyboard and mouse, while a tablet and phone will have an experience ideal for using touch screens. A native mobile app, often found in app stores and marketplaces, is not planned.
+
+### Stable, Reliable, Secure.
+
+The contributors to Actual Budget don't just write the program; they USE the program.  We all have a vested interest in maintaining reliability, security, and stability. If issues are found, bug reports are welcomed so that issues can be remedied immediately.
+
+### Privacy Focused  
+
+Actual has no trackers, and unless explicitly enabled, no third-party access is allowed.
+
+### Community-driven
+
+Actual Budget, being community-driven means that development is driven by the community and the maintainers.
+
+### Primary Objectives
+
+* Full visibility into one's budget
+  * The user owns and controls their data now, and in the future
+  * View the current status and trends in a budget
+  * Keep track of your priorities and goals, whether they are long term or short term.
+
+* Clean and fast user experience
+  * Fully usable across all devices, offline and online
+  * Multiple budgets, each one reachable by multiple devices
+  * Accessible application
+
+### Third-party use
+Actual is [MIT licensed](https://github.com/actualbudget/actual/blob/master/LICENSE.txt) which allows for the use of the software without restriction. The Actual Budget project and community appreciate any submissions from third-party contributors to enhance and improve our amazing project. This appreciation extends to any single volunteer or company-sponsored participants alike. Let's continue to make Actual Budget the best personal finance tool together!