[docs] mention logs path for osx

2 files changed, 49 insertions, 2 deletions

diff --git a/docs/hacking/index.rst b/docs/hacking/index.rst
index 3a00f3e3..8bff694c 100644
--- a/docs/hacking/index.rst
+++ b/docs/hacking/index.rst
@@ -140,6 +140,8 @@ You can also uninstall them::
   sudo `which bitmask_helpers` uninstall 
 
 
+.. note: split a Contributing page on its own, this is getting too long/messy
+
 How to contribute code
 ---------------------------------
 
@@ -224,3 +226,6 @@ Some areas in which we always need contribution are:
 * Windows and OSX packaging (talk to kali)
 * Windows Firewall integration for VPN
 * Migrating components to py3 (look for vshyba or kali).
+* Minimal C++ Qt client (see `kali's bitmaskqt5 repo`_)
+
+.. _`kali's bitmaskqt5 repo`: https://github.com/kalikaneko/bitmaskqt5
diff --git a/docs/hacking/osx.rst b/docs/hacking/osx.rst
index 5b133f04..3d2d3329 100644
--- a/docs/hacking/osx.rst
+++ b/docs/hacking/osx.rst
@@ -27,7 +27,7 @@ After those fixes, you should be able to build the bundle::
 Privileged helper
 =================
 
-The OSX privileged helper is in ``src/leap/bitmask/vpn/fw/osx/``.
+The OSX privileged helper is in ``src/leap/bitmask/vpn/helpers/osx/``.
 
 .. note: move it to vpn/helpers/osx
 
@@ -62,18 +62,60 @@ There are other helpers that the installer drops in a well-know path.
 These are shipped in ``pkg/osx``, and copied to
 ``/Applications/Bitmask.app/Contents/Resources``.
 
+
+OSX Firewall
+------------
+
+The OSX Firewall lives in ``src/leap/bitmask/vpn/helpers/osx/bitmask.pf.conf``. It gets
+installed to the same path mentioned in the previous section.
+
 .. note: cleanup unused helpers
 
 Installing the bundle with homebrew
 ===================================
 
-For testing purposes, homebrew can be used to distribute and install the
+For testing purposes, `homebrew`_ can be used to distribute and install the
 bundle. This should download and install the latest version of the bundle::
 
   brew install kalikaneko/bitmask/bitmask
+
+After that, you should be able to launch the bundle::
+
   bitmask
 
 
+.. _`homebrew`: https://brew.sh/
+
+
+Debug logs
+----------
+
+Bitmask rotates logs. The latest one can be found at::
+
+  /Users/<youruser>/Library/Preferences/leap/bitmaskd.log
+
+
+Known Issues
+------------
+
+The current state of the bundle that is distributed with homebrew is yet buggy,
+so it's in a pre-alpha state. Reports or bugfixes are welcome a this point.
+
+Major blockers for a usable homebrew distribution are:
+
+* OpenVPN is launched, but cannnot stopped https://0xacab.org/leap/bitmask-dev/issues/8924
+* Cannot find the gpg binary installed by homebrew https://0xacab.org/leap/bitmask-dev/issues/8934
+
+
+OSX Development Roadmap
+=======================
+
+1. Get a smooth 0.10 installation experience for power-users via homebrew.
+2. Merge bugfixes.
+3. Distribute Bitmask.pkg again, with the installer executing the same
+   installation scripts as homebrew Formula is doing.
+
+
 Other notes
 ===========