cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

[CLOSED] Share your favorite articles or new ideas for Meraki Documentation and win swag!

Meraki Employee

UPDATE: This contest has ended. A huge thanks to everyone who submitted their thoughts on documentation, we're excited to go through all of your feedback! Our two randomly selected winners are: @BAllen & @andrewperry, congratulations! 

 

Hi Community!

 

I'm Cameron, Knowledge Manager here at Meraki and I manage our documentation site.

 

IMG_5929.jpeg

 

The Meraki documentation site (documentation.meraki.com) includes hundreds of articles ranging from basic administration guides to deep dive troubleshooting tips for networking issues.

 

For this month’s challenge, I want to know your thoughts on one of these two questions: 

 

  1. If you had to pick the top 3 must-read articles on documentation.meraki.com, which would you select?
  2. What new content would you love to see added to our documentation?

How to enter

In a comment on this post, either list your top 3 documentation articles or provide your opinion about what new documentation content you’d like to see (or both) and be entered to win swag! Submit your thoughts in a comment on this blog post before 11 a.m. PST on Monday, February 17th (2/17/2020). We’ll then draw two at random to win an induction speaker! Your entries will be public and visible throughout the contest.

 

00100dPORTRAIT_00100_BURST20200211144927228_COVER.jpg

 

The fine print:

62 Comments
Comes here often

I would like to see Meraki cloud and Meraki MX security & SD-WAN in one device. Also this device contains different platform interface for each, this will be as you have multi-function service in one device.

Getting noticed

My biggest issue with documentation is it is wrong and not up to date.  When new features are brought out part of the introduction process should be to update the documentation.   Especially true with insight documentation.  Features are removed and added but the documentation does not reflect this.

 

Other common issue is the screens shots in the documentation are of the OLD UI and not the updated UI.  (SM documentation suffers from this a lot)

 

 

I use this one a lot to send to clients

https://documentation.meraki.com/MX/Client_VPN/Client_VPN_OS_Configuration

but it is written too technical for end users and misses step that tech people know but end users do not

Need a End user version of this

 

This one I use as well

https://documentation.meraki.com/MX/Content_Filtering_and_Threat_Protection/Configuring_Active_Direc...

 

 

More documentation on using DEP with SM  the current documentation  does not explain well the apple part of the setup  (old screens shots)

 

 

 

Just browsing

 

Very helpful and "hot" topic for me or anything related to automation via APIs.

 

The Meraki Dashboard API

https://documentation.meraki.com/zGeneral_Administration/Other_Topics/The_Cisco_Meraki_Dashboard_API

 

I would like to find Meraki Dashboard integration with the customer internal ticketing/incident system so a meaningful event at the dashboard will trigger an API call which will create an internal ticket to be routed to the appropriate IT group for review/resolution.

 

This one is helpful but needs to be expanded.

https://documentation.meraki.com/zGeneral_Administration/Other_Topics/Webhooks

 

Another great document/resource.

https://documentation.meraki.com/MR/Other_Topics/Meraki_XML_API

 

Meraki Employee

@JHoffman 

 

I'd like to see more documentation on Group Policies. I found that they are parsed top down, not cumulative so if a policy at the top can override the bottom it will. Wasn't documented anywhere.

 

There's more information on order of priority for group policies in the Troubleshooting Group Policies doc. If that wasn't clear from the main Group Policy doc, it should probably be more obvious/easier to discover, so I'll look into that.

Hopefully that's helpful?

https://documentation.meraki.com/zGeneral_Administration/Tools_and_Troubleshooting/Troubleshooting_G...

Here to help


1. If you had to pick the top 3 must-read articles on documentation.meraki.com, which would you select?
Upstream Firewall Rules for Cloud Connectivity:
https://documentation.meraki.com/zGeneral_Administration/Other_Topics/Upstream_Firewall_Rules_for_Cl...


MR Wireless Regulatory Domains:
https://documentation.meraki.com/MR/Radio_Settings/MR_Wireless_Regulatory_Domains

 

Air Marshal
https://documentation.meraki.com/MR/Monitoring_and_Reporting/Air_Marshal


2. What new content would you love to see added to our documentation?

Keeping the Dashboard documentation up to date with the releases/changes in hardware

 

Meraki Employee

@CharlieCrackle 

 

My biggest issue with documentation is it is wrong and not up to date.  When new features are brought out part of the introduction process should be to update the documentation.   Especially true with insight documentation.  Features are removed and added but the documentation does not reflect this.

Our policy is for public documentation to be a release requirement for public beta for any new features or hardware. I'll be the first to admit that things have been missed before, but we're working hard at keeping that tight. Of any of the products though, I'm a bit surprised Insight is the pain point.

 

Insight VoIP Health, as the most recent example, was documented before release. (https://documentation.meraki.com/MI/MI_VoIP_Health)

Web App Health underwent a UI overhaul, and I believe the documentation reflected the changes within a couple days. Insight should be fairly complete right now, but maybe there was a more painful spot a couple months ago?

 

Honestly, if there's anything you feel is missing though, let me know and I'll work that into our agenda.

 

 

Other common issue is the screens shots in the documentation are of the OLD UI and not the updated UI.  (SM documentation suffers from this a lot)

Yeah, you're not wrong. There are ~1800 articles, so we do have many outdated screenshots. We perform about 10-30 edits per day, and our documentation is living as much as our UI is, so we're always working to keep up. We do try to prioritize screenshot-updates in articles where the actual workflow has changed, rather than just the appearance, though we'd obviously prefer to update all of them. I understand the pain of it though, and we're working on it.

 

I use this one a lot to send to clients
https://documentation.meraki.com/MX/Client_VPN/Client_VPN_OS_Configuration
but it is written too technical for end users and misses step that tech people know but end users do not
Need a End user version of this

That's an interesting idea. Could you possibly give an example of what information is missing for technical users, and what information would be extraneous for end users?

 

 

More documentation on using DEP with SM  the current documentation  does not explain well the apple part of the setup  (old screens shots)

We're in-progress with some major updates to our DEP documentation. Keep an eye on our documentation digests, should be coming in a little while.

Meraki Employee

@ChrisGerman 

 

I would like to see this page get updated with more information as it doesn't have enough or missing. The Syslog config only has HOST but if you have tons of devices in the same IP range. It's best to use NETMASK instead of HOST which you don't have documented.

Noted, we'll try to get that fixed soon. Thanks

Conversationalist
https://documentation.meraki.com/Go https://documentation.meraki.com/MI https://documentation.meraki.com/SM Hello, I would like to see more about the new Meraki (MG Cellular Gateway) in the documentation section seems like a neat and powerful product for weak areasof cellular service!
Comes here often

I want to see a sorted logging data that can be traced in the easiest way.

Getting noticed

@CameronMoody 

thats correct. More merging the networks and organizations. 

 

I saw the MI VoIP info but we can always use more as well as some best practices. 

Meraki Employee

@LegoGeek 

 

 Without involving an SM client install we are wanting to choose where and where not certain clients have access to... in essence, they register their MAC address's and devices and we then "tell them" what they have access to

 

This might, again, not be exactly what you're looking for, but have you seen our new Trusted Access feature? Your use case sounds really similar.

 

https://documentation.meraki.com/zGeneral_Administration/Cross-Platform_Content/Trusted_Access_for_S...

 

Meraki Trusted Access is an easy, secure way to connect iOS, iPadOS, and macOS devices to Meraki MR wireless networks without enrolling the device into Systems Manager. It provides simple, secure certificate-based EAP-TLS authentication, eliminating the need to setup a certificate authority (CA) or RADIUS server.
Once you have defined which users can have access to your network, they will be able to download the configuration profile needed to join the SSID from a self-service portal using the authentication method you’ve defined for the network.

It's an SM/MR feature but it doesn't require the devices to enroll, and it allows you to have secure client connectivity without RADIUS, you manage them as normal dashboard clients. And you can apply it on an SSID-level, which allows you to separate access to your network resources with standard segmentation.

 

I think it's pretty sleek. Might be helpful?

Meraki Employee

@RussR 

Keeping the Dashboard documentation up to date with the releases/changes in hardware

 

What would you say was the most recent/egregious example of us falling short at that?

Here to help
For the beginner like me (in company using wireless product) For meraki documentation i pick this one for first time manage the device https://documentation.meraki.com/zGeneral_Administration and second one is https://documentation.meraki.com/MR ideas, should be including documentation with short video so for beginner can fast learning how to understanding the meraki product
Conversationalist

Hi there,

here my top 3 documentation articles:

 

  1. https://documentation.meraki.com/MX/Client_VPN/Client_VPN_OS_Configuration#Windows_10
  2. https://documentation.meraki.com/zGeneral_Administration/Firmware_Upgrades/Managing_Firmware_Upgrade...
  3. https://documentation.meraki.com/MX/NAT_and_Port_Forwarding/Port_Forwarding_and_NAT_Rules_on_the_MX

 

I would love to see an article about a new version of client VPN solution without changing parameters problems (maybe a Cisco vpn tool?).

Thank you

Conversationalist

Hello Cameron,

 

Thanks again to give us opportunity to jump on all the Documents view for Meraki Swag 🙂

 

I really appreciate to Meraki team for there efforts to give us a easy to learn platform here, with the regular reading and learning, i found below Three Docs is more useful for me with the SD-WAN new technology and cover the same with Meraki.

 

https://documentation.meraki.com/MR/Group_Policies_and_Blacklisting

 

https://documentation.meraki.com/MX/Site-to-site_VPN/BGP_VPN_Design_Guide

 

https://documentation.meraki.com/MX/Firewall_and_Traffic_Shaping/SD-WAN_and_Traffic_Shaping

 

 

Thank-You

Anjul Sharma

Comes here often

https://documentation.meraki.com/MX/Site-to-site_VPN/Site-to-site_VPN_Settings

Useful to understand how it works and differs from traditional configuration

https://documentation.meraki.com/MX/Client_VPN/Client_VPN_OS_Configuration

Good read and helpful for easy, straight forward deployments

https://documentation.meraki.com/SM/Deployment_Guides/Android_Enterprise_Deployment_Guide

MDM is really powerful and has been fun to play around with.

 

I would like to see possibility of more security features that may be coming.

 

Thank you.