phalcon-orphanage / docs-app Goto Github PK

It's very hard to see this menu at the first time. Also it is harder to focus when you need to move mouse and navigate between anchors.

Probably would be better to make some button which will toggle display of that menu.

Looks like it is hard to read numbers using current color scheme.

Images in png format are not optimized

centering numbers
#133

Fully qualified class names should be Phalcon\Mvc\View\Simple instead of Phalcon\\Mvc\\View\\Simple.

https://docs.phalconphp.com/ru/latest/application-micro

https://docs.phalconphp.com/en/latest/application-micro

Invalid links in the readme file
CONTRIBUTING.md & LICENSE
/cc @niden

Reviewing the application of the documentation a bit I found these 2 errors

1. The home page does not have support to translate to other languages
2. Correct flags that represent languages. currently for the arabic language the flag of ARgentina is shown, check the rest of the flags

@niden if you want I can take care of them

https://docs.phalconphp.com/non-existent-address

before
http://joxi.ru/nAypl8btgD9G52
after
http://joxi.ru/Q2Kgk7LFLQOdE2

#208

https://docs.phalconphp.com/3.4/en/tutorial.html
https://docs.phalconphp.com/3.4/en/install.html
https://docs.phalconphp.com/3.4/en/db.html
https://docs.phalconphp.com/3.4/en/samples.html
https://docs.phalconphp.com/3.4/en/tutorial-invo-2.html
https://docs.phalconphp.com/en/3.0.0/reference/volt.html
https://docs.phalconphp.com/pl/latest/reference/di.html
https://blog.phalconphp.com/post
https://blog.phalconphp.com/post/phosphorum-the-phalcons-forum
https://blog.phalconphp.com/post/20928554661/invo-a-sample-application

https://docs.phalcon.io/3.4/en/contributions#questions-and-support
From forum to discussions

Phone

DOOGEE X5 MAX

Resolution

720x1280

Actual view

If the title of an article contains an anchor we see the # in front. Can we make this title clickable so I can easily copy past the url with the anchor?

From @dschissler on July 11, 2017 22:29

I think that its bad enough that its very difficult to buy a screen that is not 16x9 because there is so much less vertical space then there used to be so that its like permanently driving with the sun visor down. Now with the banner on the top its like have two sun visors. I'd really prefer if it didn't float at all. Its enough that it just appear once at the top. In this case its fancy CSS that is reducing the usability. Also I would like the banner to be 5-10px smaller. Lets get some work done.

Copied from original issue: phalcon-orphanage/docs#1116

if click on sidebar menu

https://docs.phalcon.io/3.4/en/tutorial-basic --> 404

valid https://docs.phalcon.io/3.4/en/tutorial-base

We'll need to enable https as default protocol for docs.phalconphp.com.

// cc @niden

add manifest

Hello.
links do not work in the community menu:

Resources

In the 3.4 installation guide, under the #Macports section it says to add "extension=php_phalcon.so" to php.ini. Shouldn't it be just "extension=phalcon.so"? Also, for the macOS platform, this is only explained under the Macports section. I don't know if you also need to add it if using brew, but we are compiling from source and I had to of course add it.

add custom styles

I've looked a bit into the performance of our docs.
I think we can speed it a up a bit more by doing the following.

• Load all fonts from google fonts
• Use smaller subset in google fonts (do we really need all the characters on all pages?)
• Ask Netlify to fix caching of files.

I can't open https://phalcon.link/slack

There is an issue with URI ended with index.php/.

curl -I https://docs.phalconphp.com/index.php/

Expected response

HTTP/1.1 302 Found
Date: Sun, 09 Dec 2018 18:55:11 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
Set-Cookie: __cfduid=d4b25eb390e74f4663d4aea7af736dac41544381710; expires=Mon, 09-Dec-19 18:55:10 GMT; path=/; domain=.phalconphp.com; HttpOnly
Location: https://docs.phalconphp.com/en/3.4
X-UA-Compatible: IE=Edge
Cache-Contol: public, max-age=7200
X-Powered-By: Phalcon (https://phalconphp.com/)
Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
Server: cloudflare
CF-RAY: 4869af3d5f118412-KBP

Actual response

HTTP/1.1 404 Not Found
Date: Sun, 09 Dec 2018 18:54:25 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
Set-Cookie: __cfduid=d1e20e72c6dec1fd7c94b6023d75cf5a91544381664; expires=Mon, 09-Dec-19 18:54:24 GMT; path=/; domain=.phalconphp.com; HttpOnly
Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
Server: cloudflare
CF-RAY: 4869ae1d19cc8b76-KBP

docs inner page remove unnecessary margin

Copied from phalcon-orphanage/docs#1425

The Upgrade link in the side nav under General is not an anchor tag and does not link to anything.

Can we change the red for numbers to a lighter red or different color to create more contrast?

#165
before
http://joxi.ru/YmEglD9Fw0B3xA

after
http://joxi.ru/E2p37gBc794Ypm

#167
http://joxi.ru/krDgaDjFKKY1qA - 320
http://joxi.ru/xAeyZ0vuRRGW4A - 768

fix icon #146

I am searching function, method, class or anything but mostly found in v3.4.
I am using v4.0.
Any options for search in v4.0 documentation?

fix this problem #143
this bug in the highlight block when a long line

Currently all a lot of page titles are missing info.

<title>Phalcon Documentation - </title>

https://docs.phalcon.io/4.0/en/introduction

I would like the page title to contain info about the page for better SEO performance.
Can we do something like this:

<title>Introduction - Phalcon Documentation</title>

This should also be reflected in the social meta tags.

I'm seeing some issues regarding our sitemap.
Our sitemap contains url's with uppercase characters while our webserver is only serving lowercase (redirect if you enter uppercase). This is causing issues with indexing.

Don't think this is possible yet with out plugin. Opened an issue to this feature. See jekyll/jekyll-sitemap#251

slightly lacking height on mobile #170
http://joxi.ru/MAjdnlbtjxPjWm

fix search bar for v4 #157

https://docs.phalcon.io/4.0/ja-jp/volt#if

The English version reflects the code block without any problem, but the translated version of the document does not reflect the code block in some parts.