Commit Graph

47 Commits

Author SHA1 Message Date
Lorenzo Blasa
e38f94d254 Update docs image
Summary: ^

Reviewed By: LukeDefeo

Differential Revision: D49770479

fbshipit-source-id: 1810e2c123f16dc79123f4bd9229404351d23407
2023-09-29 09:13:17 -07:00
Andrey Goncharov
b1d2bf4b9f Add documentation for Jest E2E integration
Reviewed By: lblasa

Differential Revision: D47363239

fbshipit-source-id: 8bf46f1a9143e1b9f6b54961ba92c9e3846ac89a
2023-07-11 04:41:24 -07:00
Lukas Kurucz
d97dfae1a0 chore: add doc for martkeplace (#4395)
Summary:
Provide a documentation about marketplace feature of Flipper.

This should cover:
1. Introduction of the feature (plugin discovery, auto update)2.
2. Marketplace server - to list available plugins
3. Flipper settings - describe the new settings and how to enable4.

Closes https://github.com/facebook/flipper/issues/3545.

## Changelog

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

Reviewed By: antonk52

Differential Revision: D42918936

Pulled By: passy

fbshipit-source-id: 50b10178b569ecc6ea65b736ea58db401cf686c6
2023-02-06 08:17:47 -08:00
Luke De Feo
999e7d203a Update ui debugger docs
Reviewed By: antonk52

Differential Revision: D41768712

fbshipit-source-id: a61c07859cd419b30025f3a07e51d97a90215b7a
2022-12-06 10:00:26 -08: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
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
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
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
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
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
Anton Nikolaev
e4fb2907fd Auto-generate plugin docs
Summary:
This diff changes the way on how plugin documentation is produced. Instead of keeping plugin documentation together with other docs, we will now keep it together with plugin code. There are multiple advantages of such solution:
1. We are generating docs for every plugin in a standartised way so all of them looks similar. We can also use plugin metadata for generation as well (e.g. take title, icon, oncall name etc from package.json).
2. Standartised plugin docs make it possible to build docs both for websites (public and internal) and for embedding into Flipper.
3. It will hopefully incentivise authors to write docs as they will be a part of plugin "package".
4. We can scaffold documentation template using scarf to further incentivise filling it.

Reviewed By: jknoxville

Differential Revision: D29378053

fbshipit-source-id: 66ea48dc9ba225fabfb256ae6a10f8c81eef6f5f
2021-06-29 13:02:05 -07:00
Michel Weststrate
d2095d5937 Update to pure Sandy and update custom docs
Summary: Per title

Reviewed By: priteshrnandgaonkar

Differential Revision: D28991625

fbshipit-source-id: cab9cf59d1d053e2f8a47c588cb05abc44a527cc
2021-06-09 07:26:57 -07:00
Michel Weststrate
a0c872dd38 Update setup and createTable tutorial to 100% Sandy
Summary:
The current desktop plugin tutorial was outdated as it has several steps that are now automated, and still referred to old APIs. This has been updated now.

Additionally left the intermediate code of the tutorial in the plugin, but splitting `index.tsx` into `index_table.tsx` and `index_custom.tsx` (which will be updated in the next diff)

Clarified the tutorial page labels a little bit to show that 3 pages are covering the Desktop plugin development process.

Changelog: Updated the Desktop plugin tutorial

Reviewed By: jknoxville

Differential Revision: D28990029

fbshipit-source-id: a06a7a774ceca3daf10f8e8fbd4e03191dbfd1cc
2021-06-09 07:26:57 -07:00
Pritesh Nandgaonkar
6bd3eee0ee Add troubleshooting guide for when user tries to connect through incompatible app
Summary: This diff adds documentation and matrix explaining the supported iOS builds. It also tells about the way to enable www cert exchange.

Reviewed By: mweststrate

Differential Revision: D27676056

fbshipit-source-id: 5c8b1d0e73dd95c3ebc534fb0df7505151a6e6be
2021-04-09 06:40:08 -07:00
Bartosz Kaszubowski
b38474b73a use splash gradient in footer, switch to GitHub icon (#1998)
Summary:
This small PR aims to tweak a bit website appearance and fix small UI issue:
* footer background has been changed to reversed splash gradient
  <img width="1104" alt="Screenshot 2021-03-04 131823" src="https://user-images.githubusercontent.com/719641/109964907-8cba1c80-7cee-11eb-8905-2fa82533cfd7.png">
* GitHub link in the Navbar has been moved to the tight and text was replaced with icon (like on few other Docusaurus sites)
  <img width="557" alt="Screenshot 2021-03-04 133112" src="https://user-images.githubusercontent.com/719641/109965233-f9351b80-7cee-11eb-84d6-30788f662fbf.png">
* Navbar brand title ("Flipper") hover color issues has been fixed, now hover effect is the same as other navbar links

## Changelog

N/A

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

Test Plan: Flipper website run on `localhost`.

Reviewed By: mweststrate

Differential Revision: D26888499

Pulled By: passy

fbshipit-source-id: e8abeace8c1d6ae8dcc46c2381009c2bd2500005
2021-03-08 11:24:03 -08:00
Michel Weststrate
7b8054f31c Fixed grayed out body text
Summary: As reported a few times in the internal chat

Reviewed By: passy

Differential Revision: D26813161

fbshipit-source-id: 8b834c7807a7634f23c3ab922bb43e288ea4bd68
2021-03-04 03:18:56 -08:00
Pascal Hartig
e188469acd Add public release docs
Summary: Per title.

Reviewed By: nikoant

Differential Revision: D25535920

fbshipit-source-id: 63fc1b7f5ea122478a3e82e3345d057bc7be37cd
2020-12-14 11:27:01 -08:00
Michel Weststrate
5a56ee65b8 Fix contributing image link
Summary: Better fix for D22662057 (485b4c9827) / https://github.com/facebook/flipper/pull/1396

Reviewed By: jknoxville

Differential Revision: D22663334

fbshipit-source-id: 3a5f967e857ccc819be34903e3fb982e90823040
2020-07-24 03:38:05 -07:00
Lukas Kurucz
4d13b7ca2a Add architecture overview (#1073)
Summary:
Based on the issue here https://github.com/facebook/flipper/issues/967, I'm adding the flipper diagram to a documentation.
It should help explain briefly how does all parts communicate together and visualise key terms.

## Changelog

- Add Flipper architecture diagram to documentation
Pull Request resolved: https://github.com/facebook/flipper/pull/1073

Reviewed By: jknoxville

Differential Revision: D21278322

Pulled By: passy

fbshipit-source-id: 3cd8c71b2595b86911f5c9061bc2e8119da1d315
2020-05-29 07:05:06 -07:00
John Knox
a0cd37b5ef Distinguish links from regular text
Summary: Changes the link color to something that isn't very similar to the rest of the text.

Reviewed By: nikoant

Differential Revision: D21328856

fbshipit-source-id: 9467e368411caeb58e00642b48ef4413d285850e
2020-04-30 10:26:24 -07:00
John Knox
b483e0688d Make h3 smaller than h2
Summary:
After moving to docusaurus v2, our h3 tags are bigger than the h2 tags.
Removing our custom css fixes this, so doing that to get closer to the default theme.

Reviewed By: mweststrate

Differential Revision: D21283840

fbshipit-source-id: ceaf7488b90bbb90a463037d9e1dfcca1d694366
2020-04-28 17:33:25 -07:00
John Knox
5f1a0548f5 Migrate website to Docusaurus 2
Summary:
Docusaurus 2 is quite a lot more powerful than docu 1 it turns out.
This should convert the website fully.

* [done] Go through migration guide https://v2.docusaurus.io/docs/migrating-from-v1-to-v2
* [done] Convert landing page html
* [done] Convert all images to img tags
* [done] Convert all .md files to .mdx
* [done] Make sure ui-doc generation and including still works
* [done] Scan every page visually for sanity check
* [done] Make sure footer still works
* [done] Make sure search still works
* [done] Change all links/ to links/index
* [done] Change all links.md to links
* [done] Add some custom css to make the navbar look like the old one and darken the footer.

Reviewed By: passy

Differential Revision: D21158717

fbshipit-source-id: 5f45b711b1b6fd5ece4c5c15c55635c7ebbfb568
2020-04-27 04:05:01 -07:00
Nicolas Charpentier
201203ab84 Refresh Getting Started with the latest React Native integration (#676)
Summary:
Sync the Getting Started section about React Native integration with the latest changes in https://github.com/facebook/react-native/pull/27426.

## Changelog

Refresh Getting Started with the latest React Native integration
Pull Request resolved: https://github.com/facebook/flipper/pull/676

Test Plan: Tested in RN's template.

Reviewed By: mweststrate

Differential Revision: D18853584

Pulled By: passy

fbshipit-source-id: d001046106743b68d2f08b084c7618d8f768dea1
2019-12-10 06:07:03 -08:00
John Knox
c1b320be6e Move "Download" out of the Mac button on front page
Summary:
This didn't look quite right to me, "Download Mac", "Linux", "Windows".
Changed it to a separate "Download for", with "Mac", "Linux" and "Windows" buttons.

Reviewed By: passy

Differential Revision: D18225271

fbshipit-source-id: d644570d072029fc792cd9d9c18d8616ada0017b
2019-10-30 11:23:28 -07:00
Andres Suarez
54ebb44dda Tidy up Flipper license headers [2/2]
Reviewed By: passy

Differential Revision: D17863710

fbshipit-source-id: 5b249bdd1c06d3a526b250b035b797d0c8e796eb
2019-10-11 13:46:45 -07:00
Pascal Hartig
6b58e813e5 Add GA
Summary: Add Google Analytics code.

Reviewed By: danielbuechele

Differential Revision: D17398649

fbshipit-source-id: 79acd7a9d3ac19a25deea3f84989860308f2787e
2019-09-17 03:12:18 -07:00
Pascal Hartig
7e0b66ae8e Add linux/windows download buttons
Summary:
There's probably a more elegant way for doing this
so please let me know if you can think of something.

Reviewed By: danielbuechele

Differential Revision: D17318727

fbshipit-source-id: 9afcc30205171cfb07f0a749c552692cb40a3ced
2019-09-12 08:12:43 -07:00
Pascal Hartig
6dda7d2b63 More headers
Reviewed By: jknoxville

Differential Revision: D15199272

fbshipit-source-id: d46355a284a6e2acdaccd622dfd4419b06e61a61
2019-05-03 12:08:04 -07:00
Pascal Hartig
531b5e850c JS custom UI tutorial
Summary:
- Adding tutorial for custom JS UI
- optimizing screenshots
- fixing overlapping screenshots on landing page

Reviewed By: jknoxville

Differential Revision: D15198105

fbshipit-source-id: db53403b84a2c422650a4f80e959dad6e984d274
2019-05-03 10:21:22 -07:00
Pascal Hartig
adba73ba3c Increase top padding for code buttons
Summary: priteshrnandgaonkar pointed out that they sometimes overlap with the text.

Reviewed By: jknoxville

Differential Revision: D15182356

fbshipit-source-id: def39676d5dcce85aa0b41760cec0ec5cfb9398c
2019-05-02 10:59:13 -07:00
Daniel Büchele
8734b99f8d fixing links, adding nice buttons
Summary: as per title

Reviewed By: jknoxville

Differential Revision: D15167533

fbshipit-source-id: 67d059c478bf0608b598ba7cd6be19157ff41900
2019-05-01 11:21:54 -07:00
Daniel Büchele
563d23a514 docs: update screenshots
Summary:
Updating screenshots
adding screenshot slideshow to landing page

Reviewed By: passy

Differential Revision: D15164431

fbshipit-source-id: a7201f59205593e38b48bce87cacdb58e9b2b180
2019-05-01 03:22:35 -07:00
Daniel Büchele
1bab9ced96 docs: landing page ruler
Summary: Adding a small ruler between each section on the landing page.

Reviewed By: jknoxville

Differential Revision: D15148067

fbshipit-source-id: 604f443c06eef16570dcdfbb21e121962b325127
2019-04-30 10:09:11 -07:00
Daniel Büchele
3b03a3d605 docs: add features page
Summary: Adding a "features" page to the to bar and splitting plugin descriptions from their setup instructions.

Reviewed By: jknoxville

Differential Revision: D15147464

fbshipit-source-id: b2106d825454c3b2989eb1e536b128ef9b6d0247
2019-04-30 07:39:16 -07:00
Daniel Büchele
6c9d62c5da Fix CSS on landing page
Summary: fixing layout bug due to docusaurus upgrade

Reviewed By: passy

Differential Revision: D15122111

fbshipit-source-id: 7ecbbb34322d38f9da55bcad2e838067f83f8376
2019-04-30 02:58:04 -07:00
Pascal Hartig
d41df85ab7 Add codeblock buttons
Summary: Shamelessly ripped off from docusaurus.io

Reviewed By: jknoxville

Differential Revision: D15123501

fbshipit-source-id: 10451c72494e022af5887d4c78ef0db1ff581254
2019-04-29 15:43:22 -07:00
Pascal Hartig
ffea2ee30e Update docusaurus dependencies (#419)
Summary:
All bumps are within range, so this shouldn't introduce any breaking
changes.
Pull Request resolved: https://github.com/facebook/flipper/pull/419

Reviewed By: danielbuechele

Differential Revision: D15120854

Pulled By: passy

fbshipit-source-id: dee4b52947cb548d13cd4bf625b29e3a643d8fc3
2019-04-29 13:32:22 -07:00
Daniel Büchele
640dee6645 auto generated UI docs
Summary:
Using `react-docgen` to automatically generate docs for our UI components.
React-docgen parses the files in `components/ui` and using comments and flowtypes to generate structured information about the UI components.

For higher-order-components `react-docgen` is not able to get the information. As we are using HOC often as part of emotion's styled-components, I added a custom parser for HOCs. Using babel/parser I am parsing the components and using their doc-comments to generate the structured description.

Then, the description generated by react-docgen and my custom parser is used to generate markdown which is added to the `ui-components.md` file of our docs.

Plus: Added some styling around the documentation of props, mostly table styles.

Reviewed By: jknoxville

Differential Revision: D12896110

fbshipit-source-id: 1337c924c06e10a5d3aa752579428fd2cc7b4743
2018-11-05 03:12:23 -08:00
Pascal Hartig
5e0271cfc3 Add SVG mascot exports
Summary:
It's easier to find when they're in the repo. Exported them
from the AI template.

Reviewed By: priteshrnandgaonkar

Differential Revision: D9789825

fbshipit-source-id: ca717d130495842dcab4d06e02986d3df598dbe6
2018-09-13 08:58:03 -07:00
Pascal Hartig
3abe33af14 Flip the Flipper tooltip
Summary: Fix a small issue we had with our mascot.

Reviewed By: danielbuechele

Differential Revision: D9180345

fbshipit-source-id: de1c34768b4f75202d78bd4404798a7549aa0457
2018-08-06 14:11:54 -07:00
Daniel Büchele
7a82d56eb6 fixing links on website
Summary:
fixing broken links for:
- Twitter account
- App download
- FlipperKit image on landing page

Reviewed By: passy

Differential Revision: D9131794

fbshipit-source-id: 0e7db0ebd57757684571f0325543c35ce3ba9bec
2018-08-02 06:12:31 -07:00
Daniel Buchele
f7d487dd76 fbshipit-source-id: 2cd940396d650342920b28835f6e672febe6b55c 2018-06-12 03:39:09 -07:00
Daniel Büchele
fbbf8cf16b Initial commit 🎉
fbshipit-source-id: b6fc29740c6875d2e78953b8a7123890a67930f2
Co-authored-by: Sebastian McKenzie <sebmck@fb.com>
Co-authored-by: John Knox <jknox@fb.com>
Co-authored-by: Emil Sjölander <emilsj@fb.com>
Co-authored-by: Pritesh Nandgaonkar <prit91@fb.com>
2018-06-01 11:03:58 +01:00