Commit Graph

306 Commits

Author SHA1 Message Date
Kevin Strider
ced04c7cec Under the Hood - Part 4
Summary:
This diff includes minor changes to the pages within the Under the Hood section of Flipper Docs.

The page Creating Plugins -> Desktop Plugin APIs -> QPL Linting -> Building a Linter is now removed from the sidebar.

Reviewed By: lblasa

Differential Revision: D41533283

fbshipit-source-id: 63e50210815fe2b67ea54991eb8a7bc16e04e1be
2022-11-28 03:46:26 -08:00
Kevin Strider
fbae680e06 Under the Hood - Part 1
Summary: This diff includes minor changes to the pages within the Under the Hood section of Flipper Docs.

Reviewed By: passy

Differential Revision: D41521538

fbshipit-source-id: 35b372ffdde118faef2732e4cb7684fc9df18f87
2022-11-24 09:54:37 -08:00
Pascal Hartig
5e200dd7ec Add docs about code freeze
Summary: Wanted to write about this for a while as we're reinventing the rules every time we get to this time of the year. :)

Reviewed By: LukeDefeo, antonk52

Differential Revision: D41434886

fbshipit-source-id: 445c6c259bee74874472cf246fdc209e82514fcd
2022-11-21 05:05:54 -08:00
Lorenzo Blasa
9aee09bc70 Data pipeline deep dive
Summary: ^

Reviewed By: antonk52

Differential Revision: D41304481

fbshipit-source-id: 7ebb57d1b6940483dd273c69f9790c346363a2d0
2022-11-15 06:18:12 -08:00
Lorenzo Blasa
6f8b57bbdd Data Pipelines overview
Summary: Pretty much copy/paste from Pascal's post on data pipelines as it provides a quick overview of things involved

Reviewed By: passy

Differential Revision: D41274753

fbshipit-source-id: 337b034d2460ba448582b9dea70b835898627faa
2022-11-15 06:18:12 -08:00
Lorenzo Blasa
4ba34fcb4f Categorise 'Under the Hood -> Meta' section
Summary: ^

Reviewed By: passy

Differential Revision: D41274192

fbshipit-source-id: 602a3c79e971d6f5ea8617ac638c95131e59a820
2022-11-15 06:18:12 -08:00
Lorenzo Blasa
66984c6d13 Organise 'Under the Hood'
Summary: This change alphabetically sorts the 'Under the Hood' section and adds a 'Meta' parent category for everything that is internal as to add a visual cue of what is internal and whats not.

Reviewed By: passy

Differential Revision: D41273678

fbshipit-source-id: 1acf8da184762d5924bff90b6691be1e4be92c46
2022-11-15 06:18:12 -08:00
John Knox
c8cbdffa96 Upgrade docusaurus plugin
Summary: Doing this to get better logging in case we get transient failures again when fetching code snippets

Reviewed By: antonk52

Differential Revision: D41118788

fbshipit-source-id: f6cb9e20a08920f5935b14d765ac4c053ac5c78f
2022-11-08 06:49:27 -08:00
John Knox
2736cfeeb6 Dont gitignore website/yarn.lock
Reviewed By: passy

Differential Revision: D40936268

fbshipit-source-id: c28ad2f825b846b827ddffb555850e6adb10d83e
2022-11-02 05:23:55 -07:00
Anton Kastritskiy
c38fc9c0e4 update docusaurus-plugin-internaldocs-fb
Reviewed By: lblasa

Differential Revision: D40550389

fbshipit-source-id: bab1ac0d627cc2384a3918cde7667441edf4c614
2022-10-20 06:29:49 -07:00
Lorenzo Blasa
85c4178c22 antd update
Summary:
^

allow-large-files

Reviewed By: mweststrate

Differential Revision: D40319006

fbshipit-source-id: 79fc39dfb967d780b947a5ef302abdd0be9b5ee6
2022-10-18 03:32:31 -07:00
Anton Kastritskiy
2fb90369f1 automatic update for docusaurus-plugin-internaldocs-fb@1.0.0,@docusaurus/core@2.1.0,@docusaurus/plugin-client-redirects@2.1.0,@docusaurus/preset-classic@2.1.0
Differential Revision: D39310992

fbshipit-source-id: 18dd5e935f76fa99d4a4b377b9f5c5ac271c2e52
2022-09-08 06:56:06 -07:00
Deborah Attuah
95af1428ce automatic update for docusaurus-plugin-internaldocs-fb@0.12.3
Reviewed By: antonk52

Differential Revision: D39169091

fbshipit-source-id: 249c5f092c1b0f8e0d6f303e6ac96cdee019ecfa
2022-08-31 07:59:11 -07:00
Luke De Feo
4d5b358beb Fix broken links
Reviewed By: jknoxville

Differential Revision: D38387869

fbshipit-source-id: fa97b9b85d244db338ff89c0df474e5f3d0ff7aa
2022-08-03 09:17:20 -07:00
Anton Kastritskiy
96a23495c9 automatic update for docusaurus-plugin-internaldocs-fb@0.12.2
Reviewed By: jknoxville

Differential Revision: D38074467

fbshipit-source-id: b929f50402ca438c0359bb44ae7de335018a88f9
2022-07-22 09:07:10 -07:00
Anton Kastritskiy
013e964287 fix 404 pages
Reviewed By: jknoxville, passy

Differential Revision: D37614048

fbshipit-source-id: 58593b45193382ccdcc8a7eeb77335e663e8eb95
2022-07-05 08:19:08 -07:00
John Knox
569283a1a7 Upgrade staticdocs
Summary: This is required to enable off-VPN access to the site

Reviewed By: antonk52

Differential Revision: D37611617

fbshipit-source-id: 7599fc22766315d799345e955fc87ff3a7ddf50f
2022-07-05 04:27:19 -07:00
Pascal Hartig
c1d959d62e Start a docs page
Summary: Wanted to write down the not-obvious release procedure somewhere. We can extend this with some troubleshooting procedures.

Differential Revision: D37463848

fbshipit-source-id: 899cdfd12fdb0647579271d883f499872167743f
2022-06-28 03:43:59 -07:00
Anton Kastritskiy
2d4ae3961a update docusaurus to v2.0.0-beta.21
Reviewed By: passy

Differential Revision: D37377632

fbshipit-source-id: 3cb3f9801db393dfb4b6fef6c92f758a8be55e84
2022-06-23 08:41:12 -07:00
Kevin Strider
b81fb44017 new Contributing to the Documentation section
Summary:
This is a new section under 'Contributing to the Documentation', in the 'Under the Hood' menu.

It includes two new pages:

* Documentation Formatting Tips (created here.  For content, see D37006489)
* Writing Guide (created here.  For content, see D37006980)

Setup in sidebar.js.

Reviewed By: lblasa

Differential Revision: D37004092

fbshipit-source-id: 5fa0a38632f7fa9d9178b69a89d9b21f5bda39ab
2022-06-09 06:10:06 -07:00
Kevin Strider
b7977a954a sidebar.js
Summary: Tiny change to capitalization of a sub-menu

Reviewed By: nikoant

Differential Revision: D36931810

fbshipit-source-id: 52e6030f75e547e0936893830c702a6939ff5775
2022-06-06 09:18:24 -07:00
Anton Nikolaev
0a8577e948 Show all available sections in sidebar
Summary:
Kevin Strider after reviewing Flipper docs structure suggested to show all sections in sidebar. This will make it easier for users to navigate website as they will be able to find all the content through sidebar menu.

Before that only current section items were shown, so e.g. if user clicks "Learn more" on the start page they open "Features" section and it's not clear that there are a lot of other content (Setup, Creating Plugins, Under the Hood) which is only available through the top menu.

Reviewed By: antonk52

Differential Revision: D36762008

fbshipit-source-id: a36cfb77e5d2efd4f5d8795d1c68e46d07ed79e1
2022-05-31 02:20:39 -07:00
Pascal Hartig
8c4b494d32 Add a note about changelogs
Summary:
LukeDefeo called out that there's currently no guide for how to create changelog items.

I couldn't find another good page to add this to. Might be a good idea to expand this with further tips for making good contributions.

Reviewed By: LukeDefeo, nikoant

Differential Revision: D36702634

fbshipit-source-id: 15bc1dcf420ea923a714929eff8ac817efa56ceb
2022-05-30 03:44:28 -07:00
Kevin Strider
b75eeb941b client-plugin-lifecycle.mdx (Creating Plugins - Client Plugin Lifecycle)
Summary:
Restyle of page, including changes to spelling, grammar, links, and structure (where relevant).

This diff includes a new version of the images:
bg-plugin-lifecycle.png
regular-plugin-lifecycle.png

The old versions have been renamed to:
bg-plugin-lifecycle.bak
regular-plugin-lifecycle.bak

Reviewed By: aigoncharov

Differential Revision: D36630758

fbshipit-source-id: 29922750364e1dd6f959bd297e3b5d5e6cf1a9ac
2022-05-25 03:42:25 -07:00
Kevin Strider
ee006a961b architecture.mdx (Creating Plugins - Architecture)
Summary:
Restyle of page, including changes to spelling, grammar, links, and structure (where relevant).

This diff includes a new version of the image 'flipper-communication-diagram.png'.
The old version has been renamed to 'flipper-communication-diagram.bak'

Reviewed By: aigoncharov

Differential Revision: D36628993

fbshipit-source-id: cb59785777926b4fb8b8bb3be2aa2439d3a580d0
2022-05-25 03:26:55 -07:00
Andrey Goncharov
29eae00309 Blog post "Headless Flipper - what it means for plugin developers"
Reviewed By: passy, antonk52

Differential Revision: D36480939

fbshipit-source-id: dacbdb1af4382e9b52de79403e6aea9a0c740b1c
2022-05-20 09:47:22 -07:00
Anton Nikolaev
566f7108c9 Troubleshooting docs structure refactored
Summary: Troubleshooting docs structure refactored. This should fix publishing of docs on GitHub which is currently failing, because of link to fb-only page from public page: https://github.com/facebook/flipper/actions/runs/2351680003.

Reviewed By: passy

Differential Revision: D36513180

fbshipit-source-id: c0339d437f560464e771e46dfc0a55782faf6a54
2022-05-19 07:43:09 -07:00
Kevin Strider
81d21c6e8b new sub-folder 'Building a Desktop Plugin' (Creating Plugins)
Summary:
Major changes to js-custom.mdx

The content for the following pages is moved to the new sub-folder 'Building a Desktop Plugin':
* js-custom.mdx
* js-setup.mdx
* js-table.mdx

The Title and Sidebar labels have been changed accordingly.

Changes made to sidebar.js,

Reviewed By: lblasa

Differential Revision: D36415874

fbshipit-source-id: 8f1634abc1459d1905da62a1b76bac4b621d0da5
2022-05-19 04:31:06 -07:00
Kevin Strider
0b16f3a031 NEW troubleshooting section (SetUp)
Summary: Restyle of Trobleshooting, which involved changes to sidebar.js and splitting up the previous troubleshooting page into five separate pages.

Reviewed By: lblasa

Differential Revision: D36282539

fbshipit-source-id: e60834e2b4d98b70b23bb11309c3438d85e4de0e
2022-05-11 08:58:34 -07:00
Kevin Strider
d87fdafc9f overview.mdx (Features - Layout)
Summary: Restyle of the page, including changes to spelling, grammar, links, and structure (where relevant).

Reviewed By: passy

Differential Revision: D35898254

fbshipit-source-id: 67e3f3e344faf105f5a8f393c60441d6af3d62aa
2022-04-27 08:38:20 -07:00
Anton Kastritskiy
360c52c67c automatic update for ansi-html@0.0.8
Reviewed By: nikoant

Differential Revision: D35213089

fbshipit-source-id: 4e0d7ca6b341c8caccd1ef69a8b396ab3b6bf7ab
2022-03-29 07:06:58 -07:00
John Knox
94ae12e00e automatic update for docusaurus-plugin-internaldocs-fb@0.10.7
Reviewed By: passy

Differential Revision: D34680094

fbshipit-source-id: dd5b9ff27bf4f90b4e5624195a6aaee9031f9ffd
2022-03-07 03:50:10 -08:00
dmitryvinn
70eab186aa docs: add social banner in support of Ukraine (#3496)
Summary:
Our mission at [Meta Open Source](https://opensource.facebook.com/) is to empower communities through open source, and we believe that it means building a welcoming and safe environment for all. As a part of this work, we are adding this banner in support for Ukraine during this crisis.

![image](https://user-images.githubusercontent.com/12485205/156651121-b1479b59-a4e7-4a5c-b8d5-4265aa0aea7a.png)

Pull Request resolved: https://github.com/facebook/flipper/pull/3496

Test Plan:
Imported from GitHub, without a `Test Plan:` line.

**Static Docs Preview: staticdocs**
|[Full Site](https://our.intern.facebook.com/intern/staticdocs/eph/D34622802/V3/staticdocs/)|

|**Modified Pages**|

**Static Docs Preview: flipper**
|[Full Site](https://our.intern.facebook.com/intern/staticdocs/eph/D34622802/V3/flipper/)|

|**Modified Pages**|

Reviewed By: mweststrate

Differential Revision: D34622802

Pulled By: passy

fbshipit-source-id: a18c0de24a6a6c2311aef9a046fe65d917ce6f9d
2022-03-04 09:20:27 -08:00
Pascal Hartig
07ee7fa706 Add Support Ukraine banner
Summary:
Inspired by https://github.com/facebook/react-native-website/pull/2988

Changelog: Add Support Ukraine banner to website

Reviewed By: antonk52, aigoncharov

Differential Revision: D34627820

fbshipit-source-id: 61f69984451c504eca9a6f5e55f30d968344129e
2022-03-04 03:25:42 -08:00
Andrey Goncharov
e26ba0d945 Encapsulate styleguide styles
Summary: Prevent leaking Flipper styles and antd styles into the website by embedding the styleguide into an iframe.

Reviewed By: nikoant

Differential Revision: D34522771

fbshipit-source-id: a05bf1e7f54fe172fb012a0a02296b3a4e0100f1
2022-02-28 09:54:03 -08:00
Andrey Goncharov
342c316c84 Add style guide
Summary:
allow-large-files
See D34339758

Reviewed By: jknoxville

Differential Revision: D34378571

fbshipit-source-id: a7c845f4676b25998dc63bf3029c5d1ec8205611
2022-02-22 08:25:28 -08:00
Andrey Goncharov
3d8d43b562 Update babel config
Summary:
allow-large-files

During decapitation the style guide was accidentally removed. In this diff we bring it back and embed it into our docs.
The only caveat is that the fonts have slightly changes because we included antd.css. It does not change too much from my point of view, but I would love to hear from the team.

Reviewed By: jknoxville

Differential Revision: D34339758

fbshipit-source-id: 10d347bc805f9314ae717de483bf8b766000280f
2022-02-22 08:25:28 -08:00
Andrey Goncharov
4d1d9648f0 JS Flipper announcement
Summary: Annonce JS flipper

Reviewed By: mweststrate

Differential Revision: D33565875

fbshipit-source-id: da7140ea3a331ff3d387801410e88d1f6746bee3
2022-02-21 04:23:16 -08:00
John Knox
ab0775a987 automatic update for docusaurus-plugin-internaldocs-fb@0.10.6
Reviewed By: antonk52

Differential Revision: D34343082

fbshipit-source-id: d6baf684e951e6ad4099034595331f5ed9e764d5
2022-02-21 04:23:16 -08:00
Anton Kastritskiy
138f222cde automatic update for docusaurus-plugin-internaldocs-fb@0.10.5
Reviewed By: lblasa

Differential Revision: D34180213

fbshipit-source-id: ac5ab5b723b863df0357e988c79961ff3ee9469f
2022-02-14 08:11:56 -08:00
Anton Nikolaev
f3869bc575 Fix loading of google anaytics script
Summary:
Flipper docs were loading really slowly and I found in dev tools that was becuase of requests to scripts specified in docusaurus config which were not found because of relative urls used. This diff fixes that by specifying absolute URL for script loading.
{F696549860}

Reviewed By: jknoxville

Differential Revision: D33845659

fbshipit-source-id: 5079dba442f5fdf4b4f3b2a64146535b39ea72a4
2022-01-28 09:47:22 -08:00
John Knox
f94a3c75a4 Upgrade shelljs
Summary: Upgrading to fix https://nvd.nist.gov/vuln/detail/CVE-2022-0144

Reviewed By: antonk52

Differential Revision: D33743443

fbshipit-source-id: fe55b64c068125536b22c8ef94ccd262733938cc
2022-01-24 09:32:23 -08:00
Anton Kastritskiy
9aff968938 automatic update for docusaurus-plugin-internaldocs-fb@0.10.4
Reviewed By: nikoant

Differential Revision: D33713704

fbshipit-source-id: 2230e465bcf4481f4ee17ed7816c0d81cd4ee4aa
2022-01-24 05:04:13 -08:00
dependabot[bot]
c5fa91459f Bump follow-redirects from 1.14.3 to 1.14.7 in /website (#3285)
Summary:
Bumps [follow-redirects](https://github.com/follow-redirects/follow-redirects) from 1.14.3 to 1.14.7.
<details>
<summary>Commits</summary>
<ul>
<li><a href="2ede36d7c6"><code>2ede36d</code></a> Release version 1.14.7 of the npm package.</li>
<li><a href="8b347cbcef"><code>8b347cb</code></a> Drop Cookie header across domains.</li>
<li><a href="6f5029ae1a"><code>6f5029a</code></a> Release version 1.14.6 of the npm package.</li>
<li><a href="af706bee57"><code>af706be</code></a> Ignore null headers.</li>
<li><a href="d01ab7a5c5"><code>d01ab7a</code></a> Release version 1.14.5 of the npm package.</li>
<li><a href="40052ea8aa"><code>40052ea</code></a> Make compatible with Node 17.</li>
<li><a href="86f7572f93"><code>86f7572</code></a> Fix: clear internal timer on request abort to avoid leakage</li>
<li><a href="2e1eaf0218"><code>2e1eaf0</code></a> Keep Authorization header on subdomain redirects.</li>
<li><a href="2ad9e82b62"><code>2ad9e82</code></a> Carry over Host header on relative redirects (<a href="https://github-redirect.dependabot.com/follow-redirects/follow-redirects/issues/172">https://github.com/facebook/flipper/issues/172</a>)</li>
<li><a href="77e2a581e1"><code>77e2a58</code></a> Release version 1.14.4 of the npm package.</li>
<li>Additional commits viewable in <a href="https://github.com/follow-redirects/follow-redirects/compare/v1.14.3...v1.14.7">compare view</a></li>
</ul>
</details>
<br />

[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=follow-redirects&package-manager=npm_and_yarn&previous-version=1.14.3&new-version=1.14.7)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

 ---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `dependabot rebase` will rebase this PR
- `dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `dependabot merge` will merge this PR after your CI passes on it
- `dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `dependabot cancel merge` will cancel a previously requested merge and block automerging
- `dependabot reopen` will reopen this PR if it is closed
- `dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the [Security Alerts page](https://github.com/facebook/flipper/network/alerts).

</details>

Pull Request resolved: https://github.com/facebook/flipper/pull/3285

Test Plan:
Imported from GitHub, without a `Test Plan:` line.

**Static Docs Preview: flipper**
|[Full Site](https://our.intern.facebook.com/intern/staticdocs/eph/D33569679/V4/flipper/)|

|**Modified Pages**|

Reviewed By: aigoncharov

Differential Revision: D33569679

Pulled By: passy

fbshipit-source-id: f31911939f66d55fc35ac46c7fe3c57fc743aab3
2022-01-18 05:40:17 -08:00
Lorenzo Blasa
af8d54c6f1 Connection documentation
Summary: Space to document flipper client/server connectivity

Reviewed By: passy, aigoncharov

Differential Revision: D30864471

fbshipit-source-id: 9b9305c39b743ac6f84adf2f9f1ab0ee5da406d5
2022-01-06 06:53:04 -08:00
Lorenzo Blasa
d5f6e075af Device identifier documentation
Summary: Document how device identifiers are obtained and used to map apps and their running device.

Reviewed By: passy, aigoncharov

Differential Revision: D33431864

fbshipit-source-id: eff4475b3b5e796b58c04db872e814f3e7d5d79e
2022-01-06 04:51:23 -08:00
Michel Weststrate
7efad4201c Document how to use Node.js api's
Summary:
* Documented `npx flipper-server`
* Documented how to properly interact with the OS from Flipper plugins

Reviewed By: antonk52

Differential Revision: D33361929

fbshipit-source-id: 3028de2bf77a9ee6d9e521c1a53cff2388c936ea
2022-01-04 09:06:15 -08:00
Anton Nikolaev
a3f070c1b9 Fix docs site resource load errors
Summary: I noticed an error on loading "google-anaytics" script, "code-blocks-buttons" script and "network.png" screenshot (which is supposed to be a part of carousel on the main page) in dev console when Flipper docs website is opened. This diff fixes them. Looks like it positively affects load speed as well because each of these failed requests takes 1-2 seconds to resolve before the failure status returned.

Reviewed By: mweststrate

Differential Revision: D33313293

fbshipit-source-id: a1f6357d89121eefa2df9aeae783cd48bc3beaf5
2021-12-29 02:30:20 -08:00
Andres Suarez
79023ee190 Update copyright headers from Facebook to Meta
Reviewed By: bhamodi

Differential Revision: D33331422

fbshipit-source-id: 016e8dcc0c0c7f1fc353a348b54fda0d5e2ddc01
2021-12-27 14:31:45 -08:00
Pascal Hartig
3db072557b Start docs for on demand
Summary: Starting just with Android On Demand. iOS will follow shortly.

Reviewed By: antonk52

Differential Revision: D32724229

fbshipit-source-id: b4276aae2a7349815d691b854adcfc531b702ae7
2021-12-01 10:51:54 -08:00