mirror of
https://github.com/ash-project/ash_hq.git
synced 2024-07-27 15:30:35 +12:00
afff3dbd1b
Bumps the production-dependencies group with 8 updates: | Package | From | To | | --- | --- | --- | | [ash](https://github.com/ash-project/ash) | `3.2.2` | `3.2.6` | | [ash_graphql](https://github.com/ash-project/ash_graphql) | `1.2.0` | `1.2.1` | | [ash_json_api](https://github.com/ash-project/ash_json_api) | `1.3.7` | `1.3.8` | | [ash_oban](https://github.com/ash-project/ash_oban) | `0.2.3` | `0.2.4` | | [ash_postgres](https://github.com/ash-project/ash_postgres) | `2.1.8` | `2.1.15` | | [postgrex](https://github.com/elixir-ecto/postgrex) | `0.17.5` | `0.18.0` | | [req](https://github.com/wojtekmach/req) | `0.5.2` | `0.5.4` | | [swoosh](https://github.com/swoosh/swoosh) | `1.16.9` | `1.16.10` | Updates `ash` from 3.2.2 to 3.2.6 - [Changelog](https://github.com/ash-project/ash/blob/main/CHANGELOG.md) - [Commits](https://github.com/ash-project/ash/compare/v3.2.2...v3.2.6) Updates `ash_graphql` from 1.2.0 to 1.2.1 - [Changelog](https://github.com/ash-project/ash_graphql/blob/main/CHANGELOG.md) - [Commits](https://github.com/ash-project/ash_graphql/compare/v1.2.0...v1.2.1) Updates `ash_json_api` from 1.3.7 to 1.3.8 - [Changelog](https://github.com/ash-project/ash_json_api/blob/main/CHANGELOG.md) - [Commits](https://github.com/ash-project/ash_json_api/compare/v1.3.7...v1.3.8) Updates `ash_oban` from 0.2.3 to 0.2.4 - [Changelog](https://github.com/ash-project/ash_oban/blob/main/CHANGELOG.md) - [Commits](https://github.com/ash-project/ash_oban/compare/v0.2.3...v0.2.4) Updates `ash_postgres` from 2.1.8 to 2.1.15 - [Changelog](https://github.com/ash-project/ash_postgres/blob/main/CHANGELOG.md) - [Commits](https://github.com/ash-project/ash_postgres/compare/v2.1.8...v2.1.15) Updates `postgrex` from 0.17.5 to 0.18.0 - [Release notes](https://github.com/elixir-ecto/postgrex/releases) - [Changelog](https://github.com/elixir-ecto/postgrex/blob/master/CHANGELOG.md) - [Commits](https://github.com/elixir-ecto/postgrex/compare/v0.17.5...v0.18.0) Updates `req` from 0.5.2 to 0.5.4 - [Release notes](https://github.com/wojtekmach/req/releases) - [Changelog](https://github.com/wojtekmach/req/blob/main/CHANGELOG.md) - [Commits](https://github.com/wojtekmach/req/compare/v0.5.2...v0.5.4) Updates `swoosh` from 1.16.9 to 1.16.10 - [Release notes](https://github.com/swoosh/swoosh/releases) - [Changelog](https://github.com/swoosh/swoosh/blob/main/CHANGELOG.md) - [Commits](https://github.com/swoosh/swoosh/compare/v1.16.9...v1.16.10) --- updated-dependencies: - dependency-name: ash dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: ash_graphql dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: ash_json_api dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: ash_oban dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: ash_postgres dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: postgrex dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies - dependency-name: req dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies - dependency-name: swoosh dependency-type: direct:production update-type: version-update:semver-patch dependency-group: production-dependencies ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> |
||
|---|---|---|
| .github | ||
| .vscode | ||
| assets | ||
| config | ||
| lib | ||
| priv | ||
| rel | ||
| scripts | ||
| test | ||
| .check.exs | ||
| .credo.exs | ||
| .dockerignore | ||
| .formatter.exs | ||
| .gitignore | ||
| .tool-versions | ||
| CHANGELOG.md | ||
| dialyzer.ignore_warnings | ||
| Dockerfile | ||
| fly.toml | ||
| LICENSE.md | ||
| litefs.yml | ||
| livebook.livemd | ||
| mix.exs | ||
| mix.lock | ||
| README.md | ||
AshHq
Getting Started
- Fork and clone this repository.
- Set up the project by running
mix do deps.get, deps.compile, setup - Run
mix importto import the latest dependencies from hex (this may take a while) - Install the frontend assets by running
npm i --prefix assets. - Run the server with
iex -S mix phx.server - Open http://localhost:4000
Note to linux users: You will need the following packages (or their equivalents) to compile successfully: erlang-dev erlang-parsetools erlang-os-mon erlang-xmerl erlang-tools
A Bit of History
The docs are not static content like you would typically see for documentation. They are all stored in a database, because they can all be full-text searched using postgres. Eventually it would make sense to serve the individual doc pages from a CDN or something like that. The interesting pages in that regard is the Docs page. We do quite a bit of work to make sure that we are only loading the html that will be served for the exact document we are seeing.
The magic of search is done via AshHq.Docs.Extensions.Search, which modifies resources to make them full text searchable using postgres, amongst other things. See lib/ash_hq/docs/extensions/search/transformers/add_search_structure.ex for more.
There is also a usage of Ash.Flow for searching, which can be found in lib/ash_hq/docs/search/search.ex. It is actually a bit un-ideal, as the better thing to do would be to use a postgres UNION. There are ways to do that with Ash by extracting the resource queries and then making a union, but it was much easier to just put a search action in a flow. Eventually, Ash will support unions.