Page locked

This page is currently locked for editing by another user. You have to wait until this user finishes editing or the lock expires.

Currently locked by:
Lock expires at: 2026/09/29 06:33 (15 min)

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== F1x Documentation ======

The F1x project was invented to overcome psychological barrier of additional actions required to write and maintain documentation.

It is based on system of aliases that notify F1x server about context the user is in. A F1x window would then allow on-the-spot editing of documentation associated with the context.

===== Old-style wiki pages =====

Besides serving as F1memos storage, the wiki contains other information pieces. The only way to find them is using search. So please think carefully about which keywords the next guy is going to use to find your page. Only then add the page in question to the "index" page below:

[[index|Index page]]

===== What is context =====

Context tag is string that uniquely defines activity the user is doing at the moment. It might be server/path the user is currently in. Later on we can use other means to identify the activity (screen OCR, F1x-aware apps/breadcrumbs, inotify on files being opened, etc).

The "context switch" then causes associated documentation to show up in F1x help window, enabling user to view or edit it.

===== Examples of context ID =====

* Get into directory of a server: ``CHDIR|hungama-ingestion:/opt/tmp_14days``
  * ssh into a server: ``SERVER:bas1``
  * execute a command: ``CMD:dap2:/opt/mysql_reports_sdemo:dcmy``

===== Contexts Documentation Storage =====

Piece of documentation for a context is called "F1x memo".

Initially F1x memos are stored in the wiki, as stepping stone on a path to full-fledged F1x memos store. Backend dokuwiki engine provides important out-of-the-box capabilities, such as authentication, using browser to edit F1x memos, builtin markup language, search.

F1x memo reference is also called F1x context or simply context. It has format "COMPANY:Level1,Level2...", case insensitive.

Examples of F1memo pieces:
  * [[YmFzMTovcm9vdAo=|SERVER [bas1]]]
  * [[azhjYzovcm9vdAo=|SERVER [k8cc]]]
  * [[catchmedia:pod:gmc]]

===== F1x backend and frontend =====

During POC, frontend is JS-enabled website window that user can switch to easily (for example using F1 button). It has functions below:
  * Authenticate users
  * Receive updates from Backend about context switches
  * Open wiki page for given context in iframe

Backend receives context switches from "agents" and sends them to corresponding Frontend session.

[[frontend:future_ideas|Ideas on Frontend improvement]]

===== Context switch collection =====

==== ssh ====

F1x backend must be aware about context switches of many users so to send appropriate messages to F1x frontend. For ssh sessions and commands we employ scheme below:

- User does ssh into master using his username. Script .bashrc defines LC_F1USER environment variable
  - ssh command is actually alias that sens environment variable LC_F1USER along, like this:<code>
export LC_F1USER=skliarie@gmail.com; ssh root@bas1.catchmedia.com -o SendEnv=LC_F1USER
</code>
  - The environment variable becomes visible on the target server, thanks to allowance in sshd_config for all LC_* vars:<code>
root@bas1:~# grep LC_ /etc/ssh/sshd_config
AcceptEnv LANG LC_*
</code>
  - .bashrc script creates /tmp/f1x/tmp/PID file with content of $LC_F1USER. F1daemon watches the directory (using inotify) on tries to figure out the context, using /proc/$$/cwd symlink, pstree and other heuristics.
  - Successfully recognized context switches are sent to backend (using redis-ops pubsub for now)

==== browser ====

There might be browser add-on, that will detect [[https://stackoverflow.com/questions/11594576/getting-current-browser-url-in-firefox-addon|newly opened URLs]] and report them to F1x server for analysis and possible context matching.

==== native apps ====

//The feature is for startup-stage//. A native desktop agent identifies contexts in native apps based on various heuristics and reports them to F1x server for analysis and possible context matching.

Edit summary