apiato / documentation Goto Github PK

Searching in the docs is not working at all!

Check out the Fakers section at Test Helpers. There is a link there, which intends to point to the Test component page. This link is broken.

Now we are using docusaurus version 2.0.0-beta.6 which is an old version of the framework and we need to update it to the latest stable version which is 2.0.1 in time of creating this issue.

makeCall() is a really useful function, but it's documentation is too terse. For example, no mention is made to the test's $endpoint property, which is required by makeCall(). The documentation also does not state what makeCall actually does, or when it should be used.

The URL of the repository in the About section is docs.apiato.io but the true URL that docs placed on apiato.io/docs.

Why do you recommend using magic call method everywhere instead of using Laravel's injecting feature?

Controllers should use the function call to call Actions. (do not manually inject the Action and invoke the run).

Example gist of injecting instead https://gist.github.com/Kyslik/46eaa61c4f9a49b09935eebe7fa5b7be

private $task;

__constructor(WhateverTask $task) {
    $this->task = $task
}

public function someFunction(SomeRequest $r) {
    $this->task->run($r);
    // instead of doing the following:
    // return Apiato::call('Container@WhateverTask', [$request]);
}

I am probably not used to this kind of calling thus it irritates me :D.

What are advantages of using magic call instead of just injecting dependencies?

I currently have an issue with your documentation,
You have clearly explained the architecture design of apiato kudos for that.
But when it comes to implementation of an application and testing the implemention there is nothing mentioned in you documentation i.e
I am trying to upgrade a legacy code that used apiato I can't find any useful resource that show implementation of routing and user defined containers

hi I had some trouble running phpunit tests.
the first time because I changed the url to localhost:8080.

but I needed to install php extension like php-bcmath
it would be nice to link to Laravel php requirements during the install process

thanks

According to this link in Apiato version 11 php artisan apiato:permissions:toRole {role} command has been removed but it still exists in the documentation.

Your description should be Apiato not Apaito.

Actual usage of config is missing. How do I build up config key?
After quick research its done using config-filename.key but its not so obvious from docs http://docs.apiato.io/components/configs/